home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / wg961014.zip / WTRGATE.TXT < prev    next >
Text File  |  1996-10-14  |  288KB  |  6,692 lines
  1. W...W
  2. W.W.W
  3. .W.W.
  4.  
  5. WaterGate
  6.  
  7. Version 0.92 gamma
  8. Message processor for FidoNet and Internet/Usenet
  9. Documentation 14 October 1996
  10.  
  11. Copyright (c) 1993-1996 Waterline Software Development V.O.F.
  12. All Rights Reserved
  13.  
  14. Development by:
  15.      Ramon van der Winkel
  16.      Martijn Dijksterhuis
  17.      Michel van der Laan
  18.  
  19.  
  20. (we have removed all the graphics and high-ASCII from this file, so 
  21. it can be printed on any printer in a non-proportional font)
  22. WaterGate Manual       Table of Contents                    Page i
  23. ---------------------------------------------------------------------
  24. Table of contents
  25. -----------------
  26.  
  27. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  28.    Features. . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  29.    Requirements. . . . . . . . . . . . . . . . . . . . . . . . . 4
  30.  
  31. Welcome to WaterGate . . . . . . . . . . . . . . . . . . . . . . 5
  32.    Contacting the authors. . . . . . . . . . . . . . . . . . . . 6
  33.    Support site, newsgroup and the mailing list. . . . . . . . . 6
  34.    Disclaimer, legal stuff, license, money and you!. . . . . . . 7
  35.    Limitations in the unregistered version . . . . . . . . . . . 8
  36.  
  37. Installing WaterGate . . . . . . . . . . . . . . . . . . . . . . 9
  38.    Program description . . . . . . . . . . . . . . . . . . . . . 9
  39.       The distribution system. . . . . . . . . . . . . . . . . . 9
  40.       The gateway system . . . . . . . . . . . . . . . . . . . . 10
  41.    UUCP for beginners. . . . . . . . . . . . . . . . . . . . . . 10
  42.       About UUCP . . . . . . . . . . . . . . . . . . . . . . . . 10
  43.       About SMTP . . . . . . . . . . . . . . . . . . . . . . . . 11
  44.       UUCP spool directory . . . . . . . . . . . . . . . . . . . 11
  45.       Compressed news and batch headers. . . . . . . . . . . . . 12
  46.       UUCP Name and Domain addresses . . . . . . . . . . . . . . 12
  47.       Smart host . . . . . . . . . . . . . . . . . . . . . . . . 13
  48.    WaterGate terminology . . . . . . . . . . . . . . . . . . . . 13
  49.    Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  50.    User types. . . . . . . . . . . . . . . . . . . . . . . . . . 13
  51.  
  52. System Configuration . . . . . . . . . . . . . . . . . . . . . . 15
  53.    System Settings . . . . . . . . . . . . . . . . . . . . . . . 17
  54.       SysOp. . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  55.       System path. . . . . . . . . . . . . . . . . . . . . . . . 18
  56.       AreaFix and NewsFix. . . . . . . . . . . . . . . . . . . . 19
  57.       Duplicates . . . . . . . . . . . . . . . . . . . . . . . . 19
  58.       Max. open handles. . . . . . . . . . . . . . . . . . . . . 20
  59.       Cache .TDB files . . . . . . . . . . . . . . . . . . . . . 20
  60.       Oversized path . . . . . . . . . . . . . . . . . . . . . . 20
  61.       Log file path. . . . . . . . . . . . . . . . . . . . . . . 20
  62.       Use swap file? . . . . . . . . . . . . . . . . . . . . . . 21
  63.       Swap file path . . . . . . . . . . . . . . . . . . . . . . 21
  64.       Swap file size . . . . . . . . . . . . . . . . . . . . . . 21
  65.       Time slicing . . . . . . . . . . . . . . . . . . . . . . . 21
  66.       Minimum disk free. . . . . . . . . . . . . . . . . . . . . 22
  67.       Drives to check. . . . . . . . . . . . . . . . . . . . . . 22
  68.  
  69.    Setting up the Fido system. . . . . . . . . . . . . . . . . . 23
  70.       Fido AKAs. . . . . . . . . . . . . . . . . . . . . . . . . 23
  71.       Fido Settings. . . . . . . . . . . . . . . . . . . . . . . 25
  72.          Inbound directories . . . . . . . . . . . . . . . . . . 25
  73.          Outbound directory. . . . . . . . . . . . . . . . . . . 25
  74.          Origin lines. . . . . . . . . . . . . . . . . . . . . . 26
  75.          Fido system . . . . . . . . . . . . . . . . . . . . . . 26
  76.          Mailer rescan file. . . . . . . . . . . . . . . . . . . 26
  77.          Editor rescan file. . . . . . . . . . . . . . . . . . . 27
  78.          Max length settings . . . . . . . . . . . . . . . . . . 27
  79.          Default groups. . . . . . . . . . . . . . . . . . . . . 27
  80. WaterGate Manual       Table of Contents                    Page ii
  81. ---------------------------------------------------------------------
  82.          ArcMail names . . . . . . . . . . . . . . . . . . . . . 28
  83.       Fido Message bases . . . . . . . . . . . . . . . . . . . . 29
  84.          Auto Link . . . . . . . . . . . . . . . . . . . . . . . 29
  85.          Strip SEEN-BY . . . . . . . . . . . . . . . . . . . . . 29
  86.          Replace Tearline. . . . . . . . . . . . . . . . . . . . 29
  87.          Netmail message base. . . . . . . . . . . . . . . . . . 30
  88.          Decode files. . . . . . . . . . . . . . . . . . . . . . 30
  89.          Badmail message base. . . . . . . . . . . . . . . . . . 30
  90.          Dupes message base. . . . . . . . . . . . . . . . . . . 30
  91.          Default number and days . . . . . . . . . . . . . . . . 30
  92.          Auto create type and default path . . . . . . . . . . . 31
  93.       Fido Compression Programs. . . . . . . . . . . . . . . . . 32
  94.       Fido AreaFix Forwarding. . . . . . . . . . . . . . . . . . 33
  95.  
  96.    Setting up the UUCP System. . . . . . . . . . . . . . . . . . 34
  97.       UUCP settings. . . . . . . . . . . . . . . . . . . . . . . 34
  98.          The spool directory system. . . . . . . . . . . . . . . 35
  99.          UUCP name . . . . . . . . . . . . . . . . . . . . . . . 36
  100.          Domain addresses. . . . . . . . . . . . . . . . . . . . 36
  101.          Smart host. . . . . . . . . . . . . . . . . . . . . . . 37
  102.          Backbone. . . . . . . . . . . . . . . . . . . . . . . . 37
  103.          Default groups. . . . . . . . . . . . . . . . . . . . . 37
  104.          Time zone . . . . . . . . . . . . . . . . . . . . . . . 37
  105.          Maximum bundle size . . . . . . . . . . . . . . . . . . 38
  106.          Undeliverable mail. . . . . . . . . . . . . . . . . . . 38
  107.          Bounce small. . . . . . . . . . . . . . . . . . . . . . 39
  108.          Mail and news grades. . . . . . . . . . . . . . . . . . 39
  109.          UUCP filenames. . . . . . . . . . . . . . . . . . . . . 39
  110.       UUCP compression programs. . . . . . . . . . . . . . . . . 40
  111.       UUCP newsfix forwarding. . . . . . . . . . . . . . . . . . 42
  112.  
  113.    Gateway Settings. . . . . . . . . . . . . . . . . . . . . . . 44
  114.       Gateway AKA. . . . . . . . . . . . . . . . . . . . . . . . 45
  115.       Gateway User . . . . . . . . . . . . . . . . . . . . . . . 46
  116.       Gateway TO . . . . . . . . . . . . . . . . . . . . . . . . 46
  117.       Kill gated netmail . . . . . . . . . . . . . . . . . . . . 46
  118.       FSC-35 kludges . . . . . . . . . . . . . . . . . . . . . . 46
  119.       Fido From: . . . . . . . . . . . . . . . . . . . . . . . . 47
  120.       Copy Headers . . . . . . . . . . . . . . . . . . . . . . . 47
  121.       ASCII conversion . . . . . . . . . . . . . . . . . . . . . 48
  122.       Message-ID to MSGID conversion . . . . . . . . . . . . . . 49
  123.       Organization to Origin conversion. . . . . . . . . . . . . 49
  124.       Name separator . . . . . . . . . . . . . . . . . . . . . . 49
  125.       Small addresses. . . . . . . . . . . . . . . . . . . . . . 50
  126.  
  127.    Private mail settings . . . . . . . . . . . . . . . . . . . . 51
  128.    Log file settings . . . . . . . . . . . . . . . . . . . . . . 52
  129.    Administrator . . . . . . . . . . . . . . . . . . . . . . . . 53
  130.  
  131. Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
  132.  
  133. Area Definitions . . . . . . . . . . . . . . . . . . . . . . . . 55
  134.    Area name . . . . . . . . . . . . . . . . . . . . . . . . . . 56
  135.    Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
  136.    Area type . . . . . . . . . . . . . . . . . . . . . . . . . . 56
  137.    In groups . . . . . . . . . . . . . . . . . . . . . . . . . . 56
  138. WaterGate Manual       Table of Contents                    Page iii
  139. ---------------------------------------------------------------------
  140.    Subscribers . . . . . . . . . . . . . . . . . . . . . . . . . 57
  141.    Allow passive . . . . . . . . . . . . . . . . . . . . . . . . 57
  142.    Passive . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
  143.    Origin. . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
  144.    Custom. . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  145.    Origin AKA. . . . . . . . . . . . . . . . . . . . . . . . . . 58
  146.    Add SEEN-BY . . . . . . . . . . . . . . . . . . . . . . . . . 58
  147.    Moderated and Moderator . . . . . . . . . . . . . . . . . . . 58
  148.    Fido base and path. . . . . . . . . . . . . . . . . . . . . . 58
  149.    Fido age and limit. . . . . . . . . . . . . . . . . . . . . . 59
  150.    Decode files. . . . . . . . . . . . . . . . . . . . . . . . . 59
  151.    Files path. . . . . . . . . . . . . . . . . . . . . . . . . . 59
  152.  
  153. User Definitions . . . . . . . . . . . . . . . . . . . . . . . . 60
  154.    FidoNet style user. . . . . . . . . . . . . . . . . . . . . . 60
  155.       Organization . . . . . . . . . . . . . . . . . . . . . . . 61
  156.       Allowed groups . . . . . . . . . . . . . . . . . . . . . . 61
  157.       Subscribed to. . . . . . . . . . . . . . . . . . . . . . . 62
  158.       Passive. . . . . . . . . . . . . . . . . . . . . . . . . . 62
  159.       Address. . . . . . . . . . . . . . . . . . . . . . . . . . 62
  160.       SysOp. . . . . . . . . . . . . . . . . . . . . . . . . . . 62
  161.       Packet password. . . . . . . . . . . . . . . . . . . . . . 62
  162.       AreaFix password . . . . . . . . . . . . . . . . . . . . . 62
  163.       AreaFix special. . . . . . . . . . . . . . . . . . . . . . 63
  164.       New Area-create. . . . . . . . . . . . . . . . . . . . . . 63
  165.       Compression. . . . . . . . . . . . . . . . . . . . . . . . 63
  166.       Send format. . . . . . . . . . . . . . . . . . . . . . . . 63
  167.       Export AKA . . . . . . . . . . . . . . . . . . . . . . . . 64
  168.       Decode files . . . . . . . . . . . . . . . . . . . . . . . 64
  169.       Max PKT length . . . . . . . . . . . . . . . . . . . . . . 64
  170.       UUCP name. . . . . . . . . . . . . . . . . . . . . . . . . 64
  171.       World registered . . . . . . . . . . . . . . . . . . . . . 64
  172.       Allow sub-domains. . . . . . . . . . . . . . . . . . . . . 65
  173.       Domain addresses . . . . . . . . . . . . . . . . . . . . . 65
  174.    UUCP style user . . . . . . . . . . . . . . . . . . . . . . . 66
  175.       Compress . . . . . . . . . . . . . . . . . . . . . . . . . 67
  176.       Add batch header . . . . . . . . . . . . . . . . . . . . . 67
  177.       Remark on the use of "New Area-create" . . . . . . . . . . 68
  178.    Bag supplier. . . . . . . . . . . . . . . . . . . . . . . . . 69
  179.       Return system. . . . . . . . . . . . . . . . . . . . . . . 70
  180.       WARNING about the return system. . . . . . . . . . . . . . 70
  181.    SMTP interface user . . . . . . . . . . . . . . . . . . . . . 71
  182.       SMTP-In path . . . . . . . . . . . . . . . . . . . . . . . 72
  183.       SMTP-Out path. . . . . . . . . . . . . . . . . . . . . . . 72
  184.       Some notes . . . . . . . . . . . . . . . . . . . . . . . . 72
  185.  
  186. The List Server. . . . . . . . . . . . . . . . . . . . . . . . . 73
  187.    Subscribing to a mailing list . . . . . . . . . . . . . . . . 73
  188.    Setting up a mailing list . . . . . . . . . . . . . . . . . . 74
  189.       List name. . . . . . . . . . . . . . . . . . . . . . . . . 75
  190.       Description. . . . . . . . . . . . . . . . . . . . . . . . 75
  191.       Welcome file . . . . . . . . . . . . . . . . . . . . . . . 75
  192.       Private list . . . . . . . . . . . . . . . . . . . . . . . 75
  193.       Only known . . . . . . . . . . . . . . . . . . . . . . . . 75
  194.       Active . . . . . . . . . . . . . . . . . . . . . . . . . . 76
  195.       AKA. . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
  196. WaterGate Manual       Table of Contents                    Page iv
  197. ---------------------------------------------------------------------
  198.       Area name. . . . . . . . . . . . . . . . . . . . . . . . . 76
  199.       Echo to list . . . . . . . . . . . . . . . . . . . . . . . 76
  200.       List to echo . . . . . . . . . . . . . . . . . . . . . . . 76
  201.       Default access . . . . . . . . . . . . . . . . . . . . . . 76
  202.       Subscribers. . . . . . . . . . . . . . . . . . . . . . . . 77
  203.  
  204. The Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  205.    The echomail-news gateway . . . . . . . . . . . . . . . . . . 78
  206.       Gating echomail to news. . . . . . . . . . . . . . . . . . 78
  207.       Gating news to echomail. . . . . . . . . . . . . . . . . . 78
  208.    The netmail-mail gateway. . . . . . . . . . . . . . . . . . . 78
  209.       Using the gateway with netmail . . . . . . . . . . . . . . 79
  210.       FidoNet address to e-mail address translation. . . . . . . 80
  211.          Unknown AKA and full name . . . . . . . . . . . . . . . 80
  212.          User record, without domain address . . . . . . . . . . 81
  213.          User record, with domain address. . . . . . . . . . . . 81
  214.          Mapping statement, without full name. . . . . . . . . . 82
  215.          Mapping statement, with full name . . . . . . . . . . . 83
  216.       Creating UUCP message headers in the netmail . . . . . . . 83
  217.       Using the gateway with mail. . . . . . . . . . . . . . . . 84
  218.  
  219. The ROUTE.TDB file and its options . . . . . . . . . . . . . . . 86
  220.    ROUTE-FIDO: Route Fido messages . . . . . . . . . . . . . . . 88
  221.    ROUTE-UUCP: Route UUCP messages . . . . . . . . . . . . . . . 89
  222.       About bangpaths. . . . . . . . . . . . . . . . . . . . . . 91
  223.       Routing things you cannot do in ROUTE.TDB. . . . . . . . . 91
  224.       A few last remarks about UUCP routing. . . . . . . . . . . 92
  225.    MAP-FIDO: Mapping fido netmail messages . . . . . . . . . . . 93
  226.       Order of precedence for MAP-FIDO . . . . . . . . . . . . . 93
  227.    MAP-UUCP: Mapping UUCP mail messages. . . . . . . . . . . . . 94
  228.       Order of precedence for MAP-UUCP . . . . . . . . . . . . . 95
  229.    FORBID-FIDO/ALLOW-FIDO: Restricting the gateway . . . . . . . 96
  230.    MAP-AREA: Receive a mailing list in a message base. . . . . . 97
  231.    SIGNATURE: Adding signatures to a message . . . . . . . . . . 98
  232.    NEWSFILTER: Auto-created newsgroups filter. . . . . . . . . . 100
  233.       Logging information. . . . . . . . . . . . . . . . . . . . 101
  234.    SENDFILE: a simple file robot . . . . . . . . . . . . . . . . 102
  235.    BOUNCE: Send mail back with a reason. . . . . . . . . . . . . 103
  236.    SAVE: Write messages to disk. . . . . . . . . . . . . . . . . 104
  237.    MAP-UUCP and BOUNCE, SAVE, SENDFILE . . . . . . . . . . . . . 105
  238.    GZIPBATCH . . . . . . . . . . . . . . . . . . . . . . . . . . 106
  239.  
  240. Mail Tunnel. . . . . . . . . . . . . . . . . . . . . . . . . . . 107
  241.    How do I set it up? . . . . . . . . . . . . . . . . . . . . . 107
  242.    Incoming Tunnel Traffic . . . . . . . . . . . . . . . . . . . 108
  243.    A complete picture. . . . . . . . . . . . . . . . . . . . . . 108
  244.    A few notes . . . . . . . . . . . . . . . . . . . . . . . . . 108
  245.  
  246. Using AreaFix / newsfix. . . . . . . . . . . . . . . . . . . . . 110
  247.  
  248. Automatic file encoding / decoding . . . . . . . . . . . . . . . 112
  249.    How it works. . . . . . . . . . . . . . . . . . . . . . . . . 112
  250.    Encoding. . . . . . . . . . . . . . . . . . . . . . . . . . . 112
  251.    Decoding. . . . . . . . . . . . . . . . . . . . . . . . . . . 112
  252.  
  253. Customizing messages . . . . . . . . . . . . . . . . . . . . . . 114
  254. WaterGate Manual       Table of Contents                    Page v
  255. ---------------------------------------------------------------------
  256.    The language file . . . . . . . . . . . . . . . . . . . . . . 115
  257.    The text files. . . . . . . . . . . . . . . . . . . . . . . . 116
  258.    Filenames . . . . . . . . . . . . . . . . . . . . . . . . . . 116
  259.    Tokens. . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
  260.  
  261. Using a secondary tosser . . . . . . . . . . . . . . . . . . . . 119
  262.    Several options . . . . . . . . . . . . . . . . . . . . . . . 119
  263.    The basic construction. . . . . . . . . . . . . . . . . . . . 119
  264.    Connecting the inbound and outbound directories . . . . . . . 119
  265.    Including MailTunnel. . . . . . . . . . . . . . . . . . . . . 120
  266.  
  267. Statistical information. . . . . . . . . . . . . . . . . . . . . 121
  268.    Format of the WTRGATE.STA file. . . . . . . . . . . . . . . . 121
  269.    The WtrStat program . . . . . . . . . . . . . . . . . . . . . 122
  270.    Possible graphs . . . . . . . . . . . . . . . . . . . . . . . 122
  271.    Command line options. . . . . . . . . . . . . . . . . . . . . 123
  272.  
  273. Configuration testing with WtrTest . . . . . . . . . . . . . . . 124
  274.    Simulating an netmail . . . . . . . . . . . . . . . . . . . . 124
  275.    Simulating an e-mail. . . . . . . . . . . . . . . . . . . . . 125
  276.    Routing tables. . . . . . . . . . . . . . . . . . . . . . . . 126
  277.  
  278. System maintenance with WtrUtil. . . . . . . . . . . . . . . . . 127
  279.    Message base maintenance. . . . . . . . . . . . . . . . . . . 128
  280.       Link . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
  281.       Re-index . . . . . . . . . . . . . . . . . . . . . . . . . 128
  282.       Renumber . . . . . . . . . . . . . . . . . . . . . . . . . 128
  283.       Purge. . . . . . . . . . . . . . . . . . . . . . . . . . . 129
  284.    Log file and statistics file maintenance. . . . . . . . . . . 130
  285.    WaterGate database maintenance. . . . . . . . . . . . . . . . 131
  286.  
  287. Overlaid WtrGate . . . . . . . . . . . . . . . . . . . . . . . . 132
  288.    What is an overlay file?. . . . . . . . . . . . . . . . . . . 132
  289.    Tuning parameters . . . . . . . . . . . . . . . . . . . . . . 132
  290.  
  291. Translating from other programs. . . . . . . . . . . . . . . . . 134
  292.    Adding information from GEcho v1.02 . . . . . . . . . . . . . 135
  293.    Adding information from Waffle. . . . . . . . . . . . . . . . 136
  294.    Adding Information from Squish. . . . . . . . . . . . . . . . 137
  295.  
  296. Commandline parameters . . . . . . . . . . . . . . . . . . . . . 138
  297.    WTRGATE.EXE . . . . . . . . . . . . . . . . . . . . . . . . . 138
  298.    WTRCONF.EXE . . . . . . . . . . . . . . . . . . . . . . . . . 139
  299.    WTRUTIL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . 139
  300.       Groups filter option . . . . . . . . . . . . . . . . . . . 141
  301.  
  302. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
  303.    Appendix A: Message Bases . . . . . . . . . . . . . . . . . . 142
  304.       Fido *.MSG . . . . . . . . . . . . . . . . . . . . . . . . 142
  305.       Squish . . . . . . . . . . . . . . . . . . . . . . . . . . 143
  306.       JAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
  307.    Appendix B: Error codes . . . . . . . . . . . . . . . . . . . 147
  308.    Appendix C: Trade Marks . . . . . . . . . . . . . . . . . . . 148
  309.    Appendix D: WaterGate Development . . . . . . . . . . . . . . 149
  310. WaterGate Manual                                            Page 1
  311. ---------------------------------------------------------------------
  312. Introduction
  313. ------------
  314.  
  315. WaterGate is a message processing system. It can handle netmail and 
  316. echomail in FidoNet Technology (FTN) format and Internet e-mail and 
  317. Usenet news in several formats. It can distribute the messages in any
  318. of the supported formats and gate the messages between the different 
  319. formats.
  320.  
  321. Message "processing" means WaterGate does not do transfers, but 
  322. processes files instead. Speaking in FidoNet terminology, it is a 
  323. tosser that can handle Internet and Usenet as well.
  324.  
  325. As far as Internet and Usenet are concerned, WaterGate can process 
  326. files (jobs) in UUCP, SMTP and BAG format. UUCP is the core protocol 
  327. that WaterGate is based on and is used to transfer e-mail and news.
  328.  
  329. The terms FidoNet and UUCP will be used to differentiate between the 
  330. two systems. FidoNet refers to both netmail and echomail, where UUCP 
  331. refers to both Internet e-mail and Usenet news. WaterGate Manual       Introduction to WaterGate            Page 2
  332. ---------------------------------------------------------------------
  333.  
  334.  
  335. Features
  336. --------
  337.  
  338.    - FidoNet message processing: netmail and echomail
  339.    - Internet/Usenet message processing: e-mail and news
  340.    - Gateway between FidoNet and Internet
  341.    - Supports 65,000+ areas and nodes
  342.    - Support for *.MSG, Squish, and JAM message bases
  343.    - Built-in Remote Area Manager for FidoNet and Usenet(!)
  344.    - Utility program to perform system and message base maintenance
  345.    - Built-in Mailing List Server
  346.    - Built-in File Robot
  347.    - MailTunnel to transport FidoNet via e-mail
  348.    - Configuration program with friendly user interface
  349.    - Context sensitive online help "everywhere"
  350.    - The fastest, most complete and most user friendly around!
  351.  
  352. WaterGate Manual       Introduction to WaterGate            Page 3
  353. ---------------------------------------------------------------------
  354. Compatible with
  355.  
  356.    - FrontDoor/InterMail
  357.    - BinkleyTerm/TIMS
  358.    - d'Bridge
  359.    - Waffle's UUCICO/FX-UUCICO
  360.    - WinDis, KA9Q, Slurp, Changi
  361.  
  362. WaterGate Manual       Introduction to WaterGate            Page 4
  363. ---------------------------------------------------------------------
  364. Requirements
  365. ------------
  366.  
  367.    - An IBM Compatible computer (AT/386/486/Pentium)
  368.    - MS-DOS, OS/2, Windows '95, Windows NT or compatible Operating 
  369.      System
  370.    - About 475Kb of available "low" memory (360Kb for the overlaid 
  371.      version)
  372.    - Optionally some XMS/EMS memory
  373.    - Enough hard disk space depending on your configuration
  374.  
  375. To operate effectively, you probably need a FidoNet compatible 
  376. mailer such as FrontDoor or BinkleyTerm. Also, if you want to 
  377. exchange mail with the UUCP mechanism, a program such as UUCICO or 
  378. the faster FX-UUCICO is needed. These programs should be available 
  379. on any large BBS or FTP site.
  380.  
  381. We would like to thank the following users for testing the beta 
  382. versions of WaterGate, finding bugs, sending problem reports and test
  383. files, and making suggestions for improvements:
  384.  
  385. Miguel Lupi Alves, Mitchell Baker, Anthony Barlow, Gerrit Brinkman, 
  386. Christian von Busse, Glen Chambers, Thomas Charron, Troy Engel, 
  387. Richard Fairhead, Sue Fairhead, Frans van Geene, Guus Goos, 
  388. Christopher Henderson, John Halbig, Erik Kolodziej, Phill McKenna, 
  389. Jim Meijer, Steve Milstead, John Mudge, Pete Rocca, Bob Ross, Jan 
  390. Ruys, Robert Stark, Peter van der Steen, Joop Stokvis, Pat Trainor, 
  391. Michel Voorn, Rene Vreeman, Remco Vrolijk, Rob Waite, Jurgen van der 
  392. Wilk.
  393.  
  394. and anybody else who we forgot to mention!
  395. Special thanks to Rob Szarka of Brazerko Communications in the USA.
  396.  
  397. Explicit NO thanks to Jon Greaves and Colin Taylor for disappearing 
  398. as credit card sites, without telling us.
  399. WaterGate Manual       Welcome to WaterGate                 Page 5
  400. ---------------------------------------------------------------------
  401. Welcome to WaterGate,
  402. ---------------------
  403.  
  404. The demand for electronic mail is increasing daily, as is the number 
  405. of people reading and writing electronic messages. There is FidoNet, 
  406. connecting thousands of Bulletin Board Systems and their users on 
  407. all continents, and there is Internet, to which almost every 
  408. university and major company has a connection. Then there are 
  409. numerous other networks, using technology similar to the ones 
  410. mentioned.
  411.  
  412. WaterGate is a mail processing program capable of processing both 
  413. messages that were created by a FidoNet Technology compatible 
  414. program, and messages created by a program that supports RFC822, the 
  415. protocol widely used within Internet for e-mail. Finally, it 
  416. supports a variant to the RFC822 protocol that is used for the over 
  417. 10000 newsgroups within Internet, also known as Usenet.
  418.  
  419. From now on, the term UUCP will be used for both Internet e-mail and 
  420. Usenet news, just like FidoNet refers to both netmail and echomail.
  421.  
  422. WaterGate was written to simplify the process of connecting both 
  423. FidoNet and UUCP compatible systems by integrating the four steps 
  424. needed to build a FidoNet/UUCP message host:
  425.  
  426.   1. Process and distribute UUCP messages, for us and other systems.
  427.   2. Process and distribute FidoNet messages, for us and other 
  428.      systems.
  429.   3. Translate (gate) messages between the two formats.
  430.   4. Import either style message into message bases.
  431.  
  432. So, no matter if you are a Fido point, node, hub, zonegate, or UUCP 
  433. node or hub, WaterGate is the program to use for processing all your 
  434. netmail, echomail, mail and news.
  435.  
  436. In addition to that, it is loaded with tools and features like 
  437. AreaFix for both FidoNet and UUCP(!!), mailing list server, 
  438. read-only areas, file robot and options to import data from your 
  439. previously favorite programs. We plan to support other transport 
  440. mechanisms and mailers in future as well. It was designed to do this.
  441.  
  442. We hope WaterGate achieves its design goals: ease of configuration 
  443. of both WaterGate and your complete mail processing system, speed of 
  444. operation, computability, and stability.
  445.  
  446. The authors
  447. WaterGate Manual       Welcome to WaterGate                 Page 6
  448. ---------------------------------------------------------------------
  449. Contacting the authors
  450. ----------------------
  451.  
  452. The authors can be contacted at the following addresses:
  453.  
  454. Ramon van der Winkel
  455. Internet: ramon@wsd.wline.se
  456.  
  457. Michel van der Laan
  458. Internet: michel@nijenrode.nl
  459.  
  460. Support site, newsgroup and the mailing list
  461. --------------------------------------------
  462.  
  463. The WSD (Waterline Software Development) system at wsd.wline.se is 
  464. our support site, operated by Ramon van der Winkel. Mail your 
  465. problems and requests to ramon@wsd.wline.se. The latest patches are 
  466. always requestable from our file robot. Send a message to  
  467. watergate-info@wsd.wline.se to get a text file with a description of 
  468. all the files you can request.
  469.  
  470. There is a newsgroup as well: alt.bbs.watergate.
  471. Unfortunately, there are some distribution problems, apart for the 
  472. continuous spam postings. Everything seems to work properly from the 
  473. USA side, but posting in Europe doesn't make it far.
  474.  
  475. Finally, there is the WaterGate mailing list. To subscribe, write a 
  476. message to listserv@wsd.wline.se and put the following command in 
  477. the body of the message: "connect watergate" (without the quotes). 
  478. After the reply from the listserver, you can send your problems to  
  479. watergate@wsd.wline.se to have them distributed to everybody else 
  480. that is connected to the mailing list. The main use of the mailing 
  481. list is for announcements by the authors.
  482. WaterGate Manual       Welcome to WaterGate                 Page 7
  483. ---------------------------------------------------------------------
  484. Disclaimer, legal stuff, license, money and you!
  485. ------------------------------------------------
  486.  
  487. "WaterGate" refers to all executables and documentation included in 
  488. the package that was released.
  489.  
  490. WaterGate is (c) Copyrighted material by Waterline Software 
  491. Development V.O.F. in The Netherlands. By using this software you 
  492. accept the terms of the license agreement stated below.
  493.  
  494.    - WaterGate is released as Shareware, you may use the unregistered
  495.      version of this program for a trial period of thirty (30) days. 
  496.      After this period you MUST either register WaterGate or stop 
  497.      using it.
  498.    - WaterGate is provided 'as is', without warranty of any kind, 
  499.      neither expressed nor implied. Waterline Software Development 
  500.      only guarantees that WaterGate will occupy disk space.
  501.    - In no event is Waterline Software Development liable to you or 
  502.      anyone else for any damages, including lost profits, lost 
  503.      savings or other incidental or consequential damages arising 
  504.      out of the use of WaterGate.
  505.    - In no way is Waterline Software Development obliged to you or 
  506.      anyone else to provide future versions of WaterGate.
  507.    - All mentioned products and packages are copyrighted by and 
  508.      trademarks of their respective holders. If you are using 
  509.      WaterGate in a non-commercial environment refer to the 
  510.      REGSITES.DOC file for information on how to register. 
  511.      Commercial users have to contact the authors for more 
  512.      information.
  513.  
  514. A commercial environment is any of the following:
  515.  
  516.    - Business
  517.    - Government
  518.    - Organization
  519.    - Foundation
  520.    - School
  521.    - Any other form of juridical person
  522.    - Any form of system where WaterGate is used to make a profit, 
  523.      direct or indirect.
  524.  
  525. Remember that WaterGate is currently in a GAMMA phase. This means it 
  526. needs extensive testing by YOU! Most parts of it are currently used 
  527. by a number of larger sites, but this doesn't mean it is 
  528. trouble-free all through! Stay up to date with the latest release. 
  529. We try to release a new version at least every two months, so read 
  530. ALT.BBS.WATERGATE or connect to the mailing list for release 
  531. announcements.
  532.  
  533. Please do support the Shareware concept.
  534. WaterGate Manual       Welcome to WaterGate                 Page 8
  535. ---------------------------------------------------------------------
  536. Limitations in the unregistered version
  537. ---------------------------------------
  538.  
  539. You can use all options when not registered. WaterGate does not 
  540. contain a time lock or limitations whatsoever, except for the 
  541. following:
  542.  
  543.    - The fact that you are not registered is reflected in a few 
  544.      places, like the Received: header in an e-mail, the tear-line 
  545.      in a netmail and echomail, the PID, TID and Via kludges.
  546.    - The tear-line replacement option is always ON which means all 
  547.      tear-lines are replaced by "WtrGate vX.yy Unreg".
  548.    - WtrGate accepts only five (5) MAP-UUCP statements in the 
  549.      ROUTE.TDB file. This statement allows you to connect a nice 
  550.      e-mail address to a FidoNet style user. You can do without 
  551.      this, so five is not really a limitation.
  552.    - WtrGate accepts only four (4) TUNNEL statements (TUNNEL-TO and 
  553.      TUNNEL-FROM) in the ROUTE.TDB file. This limits you to two 
  554.      bi-directional Mail Tunnels.
  555.    - WtrGate waits five seconds when you exit the program and then 
  556.      continues.
  557.  
  558. That is all. There is no limitation to the number of users, areas, 
  559. mailing lists, send files, routings, domain names, networks, AKAs or 
  560. what so ever. The limitations still allow you to evaluate the product
  561. to its full extent.
  562. WaterGate Manual       Installing WaterGate                 Page 9
  563. ---------------------------------------------------------------------
  564. Installing WaterGate
  565. --------------------
  566.  
  567. Before you go through the step-by-step installation, please read 
  568. this chapter first. After reading it, you will know about the basic 
  569. issues that are involved with WaterGate and understand the big 
  570. picture when installing the smaller parts.
  571.  
  572. Program description
  573. -------------------
  574.  
  575. WaterGate supports the FidoNet and UUCP technologies. Throughout 
  576. this chapter we will assume you need support for both of them. You 
  577. can see them as two separate flows of messages that only touch when 
  578. messages are going through the gateway. Have a look at the following 
  579. two pictures that describe the distribution abilities of WaterGate.
  580.  
  581. The distribution system:
  582.  
  583.   +------+  +----+  +---------+  +-------+  +--------------+
  584.   | UUCP |  |SMTP|  |satellite|  |FidoNet|  |optional other|
  585.   |uplink|  |link|  |receiver |  |uplink |  |FidoNet uplink|
  586.   +--+---+  +--+-+  +----+----+  +---+---+  +------+-------+
  587.      |         |       \|/           |              |
  588.   +--+---------+--------+------------+--------------+------+
  589.   |                W  A  T  E  R  G  A  T  E               |
  590.   +--+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+---+-----+
  591.      | | | | | | | | | | | | | | | | | | | | | | |   |
  592.      U P P P N P U P N P P P N U P P U U U U U U P   |
  593.                                                +-----+-------+
  594.   U = UUCP-style user                          |local system |
  595.   N = FidoNet-style node                       |message bases|
  596.   P = FidoNet-style point                      |like BBS     |
  597.                                                +-------------+
  598.  
  599. The pictures shows a few systems that provide the big message traffic
  600. to you. The satellite receiver is optional, of course, but is put 
  601. here because WaterGate supports it. Whereas you can be in more than 
  602. one network with the FidoNet technology, there is only one Internet 
  603. and thus you have only one UUCP uplink.
  604.  
  605. On the bottom side you see the systems that receive their messages 
  606. from your system. WaterGate allows FidoNet style systems to receive 
  607. UUCP messages and vice versa. The messages can also be imported into 
  608. a message base for your BBS, or for you to read.
  609.  
  610. Don't worry if your system is not as big as in the picture above. You
  611. can use WaterGate as well if you are `just' a FidoNet style node or 
  612. point, with possibly a UUCP feed as well.
  613.  
  614. The next picture shows what WaterGate does to provide the 
  615. interchangeability of the messages between UUCP and FidoNet. The top 
  616. and bottom bars are the UUCP and FidoNet message flows respectively 
  617. and in the middle is the WaterGate program.
  618. WaterGate Manual       Installing WaterGate                 Page 10
  619. ---------------------------------------------------------------------
  620. The gateway system:
  621.  
  622.   ------------------------- - - - -------------------------
  623.    mail                 SMTP/UUCP/BAG                 news
  624.   -----+--------+-------+-- - - - ---+------+---------+----
  625.        |        |       |            |      |         |
  626.    +---+---+ +--+----+ ++------------++ +---+---+ +---+---+
  627.    |newsfix| | mail  | | mailinglists | | news  | |message|
  628.    |AreaFix| |gateway| |    server    | |gateway| | bases |
  629.    +---+---+ +--+----+ ++------------++ +---+---+ +---+---+
  630.        |        |       |            |      |         |
  631.   -----+--------+-------+- - - - - - +------+---------+----
  632.    netmail                 FidoNet                echomail
  633.   ------------------------ - - - - - ----------------------
  634.  
  635. The internal parts of WaterGate can be divided into the parts 
  636. described above. It can process mail, news, netmail, and echomail to 
  637. and from UUCP and FidoNet.
  638.  
  639. If it is necessary for a mail or netmail message to go to the other 
  640. network, it goes through the mail gateway. There is a different 
  641. gateway for the news, but that one is almost invisible to the users. 
  642. The mail gateway can be addressed from both networks.
  643.  
  644. News flows in newsgroups, and echomail flows in echoes. Inside 
  645. WaterGate we simply call them areas. To connect and disconnect areas,
  646. the users have to write a netmail or mail message to AreaFix so the 
  647. system operator (that's you) doesn't have to do all that work 
  648. manually.
  649.  
  650. On the far right side of the picture are the message bases. Every 
  651. message that flows through an area can be imported into a message 
  652. base as well. WaterGate supports the *.MSG, Squish, and JAM message 
  653. base formats. In fact, there is also a netmail messagebase (not 
  654. shown in the drawing).
  655.  
  656. The big box in the middle of the picture is not WaterGate's heart, 
  657. but is the mailing list server. A mailing list is like a private 
  658. newsgroup. If a message is sent to a mailing list, all users 
  659. connected to that list receive the message by mail or netmail. So, 
  660. the mailing list is just a list of receiver addresses. It is also 
  661. possible to connect the mailing list to an area so you can connect a 
  662. newsgroup or echo, but that is mainly intended to import the 
  663. messages into a message base. This explains why the box in the 
  664. middle of the drawing has so many connections.
  665.  
  666. UUCP for beginners
  667. ------------------
  668.  
  669. There are a lot "FidoNet people" that want to connect the Internet 
  670. and receive e-mail and news. The "Internet related" terms used in 
  671. WaterGate are not always familiar to them. This short chapter 
  672. therefore explains how the "other" system works.
  673.  
  674. WaterGate Manual       Installing WaterGate                 Page 11
  675. ---------------------------------------------------------------------
  676. About UUCP
  677. ----------
  678.  
  679. To receive mail and news and process it with WaterGate, you need a 
  680. UUCP connection to an Internet Provider. These providers mostly sell 
  681. PPP and SLIP connections and give you an account to login and a 
  682. mailbox. After connecting to them and using special software, you 
  683. can read your e-mail.
  684.  
  685. The problem with these links is that you only have one mailbox and 
  686. thus one e-mail address. WaterGate was made to handle loads of e-mail
  687. addresses, sub-systems (downlinks) (basically *@*.yourdomain), so 
  688. have to ask for a UUCP connection instead.
  689.  
  690. Once you have this connecting, your provider will store all news you 
  691. want to receive and all e-mail for your system and your downlink 
  692. systems. When you connect to them, you pick up all this mail and 
  693. news using the UUCP protocol.
  694.  
  695. WaterGate cannot do this for you. WaterGate is a tosser and not a 
  696. mailer. You need a program like Waffle's UUCICO or the FX-UUCICO 
  697. program to send and receive your UUCP "batches" as they are called.
  698.  
  699. About SMTP
  700. ----------
  701.  
  702. If UUCP is not available, then you might still be able to use 
  703. WaterGate. We added support for SMTP and BAG systems.
  704.  
  705. SMTP is the protocol used on the Internet to transport mail messages,
  706. but not news. You need a special program to get the mail from your 
  707. provider, where after WaterGate can process it. You can also use SMTP
  708. for outgoing mail. WaterGate will queue it up on your hard disk and 
  709. the special application can then send it. Examples of these programs 
  710. are WinDis and KA9Q.
  711.  
  712. The BAG support is a generic format for storing a lot of news (and 
  713. optionally mail) messages in one file. There are programs that allow 
  714. you to retrieve news from a so called "news server" and store these 
  715. articles in a .BAG file. You can then use WaterGate to process these 
  716. BAG files. Notice that there is no way at this moment to get news 
  717. back to the news server using BAG files. Examples of programs to 
  718. download news and store these as BAG files are WinDis, Slurp and 
  719. Changi.
  720.  
  721. UUCP spool directory
  722. --------------------
  723.  
  724. These batches are stored in your "spool directory", which is a 
  725. sub-directory on your hard disk, for example C:\SPOOL\. Your UUCP 
  726. uplink system has a sub-directory there, as well as your UUCP style 
  727. downlink systems. Not your FidoNet style downlink systems, they have 
  728. the inbound and outbound directories.
  729.  
  730. In these spool directories you will find files with the names *.X, 
  731. *.D, *.XQT, *.DAT and *.CMD. The first two are incoming (inbound, 
  732. WaterGate Manual       Installing WaterGate                 Page 12
  733. ---------------------------------------------------------------------
  734. received) files. WaterGate processes these files. The last three are 
  735. outgoing (outbound, to be sent) files. The XQT file will end up on 
  736. the other system's hard disk like a .X file and the .DAT file as a 
  737. .D file. The .CMD file is used by the UUCICO (UUCP mailer) program 
  738. and tells it which files to transfer.
  739.  
  740. The .X file is the so called "envelope" file and the .D file the 
  741. letter itself. Each e-mail file has a .X file in which WaterGate 
  742. finds the e-mail address of the recipient and a reference to the .D 
  743. file, amongst others. In case of news, the .X file contains the 
  744. recipient name "rnews".
  745.  
  746. Each e-mail message has its own .X and .D file. The news is bundled 
  747. and you will find one .X file for each .D file with a number of news 
  748. message in it. The .D file is mostly limited by size, not by number 
  749. of news messages.
  750.  
  751. Compressed news and batch headers
  752. ---------------------------------
  753.  
  754. To reduce the transfer time, news batches are mostly compressed. 
  755. E-mail is never compressed. There are two forms of compression used 
  756. with UUCP: the older 12-bit or 16-bit "compress" and the nowadays 
  757. more common "gzip".
  758.  
  759. Because of this compression, you cannot read the .D files with news 
  760. directory. You have to decompress them first.
  761.  
  762. To make it easier for a script-based UNIX machine to detect the 
  763. compression format, a special "batch header" is added to the start 
  764. of the compressed file. When the file is compressed with normal 
  765. compress, you will find the header "#! cunbatch" there. When it is 
  766. compressed with gzip you will find the header "#! gunbatch" or "#! 
  767. zunbatch" there.
  768.  
  769. WaterGate automatically detects all these headers and compressed 
  770. formats and decompressed the .D files.
  771.  
  772. UUCP Name and Domain addresses
  773. ------------------------------
  774.  
  775. There are two key issues involved in addressing in the Internet 
  776. world: UUCP name and domain address.
  777.  
  778. The "UUCP name" is the is a name of maximum 12 characters that 
  779. identifies your system from your neighbors. You and your direct 
  780. neighbor systems (systems you exchange messages with) need to have a 
  781. unique UUCP name.
  782.  
  783. The more important "domain address" identifies your system 
  784. world-wide. My UUCPname is "wsd" and my domain address is 
  785. "wsd.wline.se".
  786.  
  787. When you want to create UUCP downlinks, you have to give them an (for
  788. your system) unique UUCP name. You only almost never have to give 
  789. Fido downlinks a UUCP name.
  790. WaterGate Manual       Installing WaterGate                 Page 13
  791. ---------------------------------------------------------------------
  792. Your e-mail address is always <username>@<domain address>, for 
  793. example "ramon@wsd.wline.se", where the part before the @ is called 
  794. "user name".
  795.  
  796. Smarthost
  797. ---------
  798.  
  799. All mail to domains not know at your system are sent to the "smart 
  800. host", which is mostly the computer of your UUCP service provider. 
  801. That computer will then know how to transport the message to the end 
  802. system.
  803.  
  804. Internally, WaterGate depends heavily on the UUCP names. You have to 
  805. define one system as the smart host by telling WaterGate that 
  806. system's UUCP name.
  807.  
  808. WaterGate terminology
  809. ---------------------
  810.  
  811. To configure the WaterGate system, you have to use the WtrConf 
  812. program. Inside this program you can create the areas, mailing 
  813. lists, receiving users, and uplink systems. Note that the latter two 
  814. are logically the same for WaterGate.
  815.  
  816. A message that is received from a user is sent to all other users 
  817. connected to that same area, no matter if that user is an uplink 
  818. system or not. Read that again, because all WaterGate does is based 
  819. on this!
  820.  
  821. You also use the WtrConf program to configure all the other system 
  822. related items. An exception is the ROUTE.TDB ASCII configuration file
  823. that contains the routing information, mapping commands, and gateway 
  824. restrictions. You don't need this file right away when you start to 
  825. set up your system. Most of these items will be moved into the 
  826. WtrConf program some day.
  827.  
  828. Groups
  829. ------
  830.  
  831. WaterGate allows you to separate the areas from the different 
  832. networks into 26 groups. An area has to be in at least one group, 
  833. but can also be in more than one group. That way you can give one or 
  834. more users access to a certain group in which they can only connect 
  835. to some of the areas you have. You can also easily divide the UUCP 
  836. and FidoNet networks into groups. And it is also possible to make a 
  837. group read-only so that users subscribing to areas in that group 
  838. cannot post messages in it, but only receive messages from it.
  839.  
  840. If a message is received in an area that is not defined in your 
  841. system, you can have WaterGate create that area automatically (and 
  842. optionally a message base as well). You can enable this for your 
  843. uplinks and save yourself a lot of typing work.
  844.  
  845. WaterGate Manual       Installing WaterGate                 Page 14
  846. ---------------------------------------------------------------------
  847. User types
  848. ----------
  849.  
  850. There are a few different user types that you have to be aware of 
  851. before you start creating users. The big difference between the 
  852. users is the way they communicate with your system: with UUCP, SMTP, 
  853. BAG files or in FTN (FidoNet) packets. Aside from that, you can 
  854. assign UUCP addresses to FidoNet users. That way, a user with 
  855. FidoNet address 2:280/802 can have an Internet domain address like 
  856. bbsw.wlink.nl. If a user on that system sends a message to Internet, 
  857. his address will be a nice Internet address instead of something 
  858. like user@f802.n280.z2.wlink.nl.
  859.  
  860. Resuming, there are UUCP users, SMTP users, BAG suppliers and FidoNet
  861. users.
  862.  
  863. The last thing you have to do before you start setting up the system 
  864. is think about the addresses and names the system will be known as. 
  865. This is very important, because a lot of errors are made with the 
  866. assignment of addresses. Try to write down the addresses of your 
  867. uplink(s), the addresses and names of your WaterGate system, and 
  868. some of the addresses of your downlinks (users). This will make it a 
  869. lot easier to configure the system.
  870.  
  871. Note that users who receive UUCP and FidoNet messages need not be 
  872. defined twice in the userbase, but if the same user receives messages
  873. from two different FidoNet networks, you do have to define him/her 
  874. under both addresses in the userbase.
  875. WaterGate Manual       System Configuration                 Page 15
  876. ---------------------------------------------------------------------
  877. System Configuration
  878. --------------------
  879.  
  880. The following pages describe the installation of WaterGate by going 
  881. through all the possible entries in WtrConf. After that, we assume 
  882. that you have become familiar with the system and explain several 
  883. complete installations. This chapter will also teach you to use the 
  884. user interface.
  885.  
  886. During this documentation, the term WaterGate refers to the entire 
  887. package and the terms WtrGate, WtrConf and WtrUtil refer to separate 
  888. programs of this package.
  889.  
  890. To start, unpack the archive containing the program files into a new 
  891. directory on your hard disk, for example C:\WTRGATE. At least the 
  892. following three executables should be present in the archive:
  893.  
  894. WTRGATE.EXE
  895. WTRCONF.EXE
  896. WTRUTIL.EXE
  897.  
  898. You might want to set a environment variable called WTRGATE to this 
  899. directory so WaterGate knows where to find its configuration files 
  900. when not started from its home directory. Add this line to your 
  901. autoexec.bat file:
  902.  
  903. SET WTRGATE=C:\WTRGATE
  904.  
  905. Then run the configuration program, WtrConf, to create new 
  906. configuration and database files. If you don't run it from the 
  907. installation directory, make sure the WTRGATE environment variable 
  908. is set, as indicated above. You might want to reboot or set it 
  909. manually before continuing.
  910.  
  911. After starting WtrConf, you will see the following menu: WaterGate Manual       System Configuration                 Page 16
  912. ---------------------------------------------------------------------
  913.  
  914.  
  915.     +-------------------------+
  916.     |        Main Menu        |
  917.     +-------------------------+
  918.     | System configuration    |
  919.     | Area definitions        |
  920.     | User definitions        |
  921.     | List Server definitions |
  922.     | Group descriptions      |
  923.     | Import/export menu      |
  924.     | About WaterConf         |
  925.     | Exit program            |
  926.         +-------------------------+
  927.  
  928. You can select a menu line with the cursor keys up and down. To 
  929. select one of the options, press enter. You can also exit a menu by 
  930. pressing escape. In this case, pressing escape will present another 
  931. menu, asking if you really want to quit the program. Select Yes and 
  932. press enter to quit, or press escape again to return to the main 
  933. menu. You can also exit the program by selecting the bottom menu 
  934. option. To get there, use the cursor keys or press PgDn (page down).
  935.  
  936. To get back at the top of the menu, press PgUp (page up). You can 
  937. also use the Home and End keys. You can always use function key F1 
  938. to get context sensitive help. Try pressing F1 in the Main Menu.
  939.  
  940. To remove the help window, you have to press escape. It is sometimes 
  941. possible to use special keys in the help screens, like PgUp and PgDn.
  942. The help screens will tell you when.
  943.  
  944. Last remark before we start. Have a look at the bottom line of the 
  945. screen. It shows most of the keys you can use throughout the program 
  946. and will change to reflect the keys you can use at a certain point.
  947.  
  948. We start with System Configuration, so select the top option from the
  949. Main Menu and press enter. You are now presented with a new menu, 
  950. which looks like this: WaterGate Manual       System Configuration                 Page 17
  951. ---------------------------------------------------------------------
  952.  
  953.  
  954.     +---------------------------+
  955.     | System configuration menu |
  956.     +---------------------------+
  957.     | System settings           |
  958.     | Fido system AKAs          |
  959.     | Fido settings             |
  960.     | Fido message bases        |
  961.     | Fido compression programs |
  962.     | Fido areafix forwarding   |
  963.     | UUCP settings             |
  964.     | UUCP compression programs |
  965.     | UUCP newsfix forwarding   |
  966.     | Gateway settings          |
  967.     | Private mail options      |
  968.     | Logfile settings          |
  969.     | Administrator settings    |
  970.     +---------------------------+
  971.  
  972. The System configuration menu is split into several parts, starting 
  973. with general system settings, followed by five options that have to 
  974. do with FidoNet settings, followed by three options for UUCP 
  975. configuration settings. The last separate options are to setup the 
  976. gateway and the private mail scanning system, to tune the log file 
  977. and to setup the administrator.
  978.  
  979. System settings
  980. ---------------
  981.  
  982. Let's start with System settings. Press enter to get the screen: WaterGate Manual       System Configuration                 Page 18
  983. ---------------------------------------------------------------------
  984.  
  985.  
  986.     +-------------------------------------------+
  987.     | SysOp             Ramon van der Winkel    |
  988.     | System path       C:\WTRGATE\             |
  989.     | Areafix name      AreaFix                 |
  990.     | Newsfix name      newsfix                 |
  991.     | Dupe checking     OFF on                  |
  992.     | Dupe checks       10000                   |
  993.     | Max. open handles 8                       |
  994.     | Cache .TDB files  OFF on                  |
  995.     | Oversized path    C:\WTRGATE\TOOBIG\      |
  996.     | Log file path     C:\WTRGATE\WTRGATE.LOG  |
  997.     | Use swap file?    off ON                  |
  998.     | Swap file path    C:\WTRGATE\WTRGATE.SWP  |
  999.     | Swap file size    2                       |
  1000.     | Time slicing      no YES                  |
  1001.     | Minimum disk free 10 Mb                   |
  1002.     | Drives to check   C                       |
  1003.     +-------------------------------------------+
  1004.  
  1005. This is a window with fields where you can enter data. You can use 
  1006. the cursor keys up and down to go through the fields. There are a 
  1007. number of different type of editing fields, but they all have one 
  1008. thing in common: press enter to edit the contents.
  1009.  
  1010. SysOp
  1011. -----
  1012.  
  1013. The first field in this window is "SysOp". You have to put your name 
  1014. there. Since this is a text field, you can either press enter and 
  1015. edit away or you can start typing at once, without first pressing 
  1016. enter. This will clear the current contents of the field. So, press 
  1017. enter if you want to change its contents, or just start typing to 
  1018. completely replace it.
  1019.  
  1020. When editing a text field, you can always press escape to stop 
  1021. editing and restore the old contents. If you are satisfied with the 
  1022. new contents, you have to press the enter key to accept the changes. 
  1023. Inside the field, you can use the cursor keys left and right to move 
  1024. the cursor through the field. The backspace and delete keys work as 
  1025. expected. Insert mode is always on, though.
  1026.  
  1027. You can clear the contents of the field from the cursor position to 
  1028. the end of the field, by using the WordPerfect method: ctrl+end. To 
  1029. jump to the following or previous word, you can hold down the 
  1030. control key (ctrl) and use the cursor keys again. Finally, the home 
  1031. key brings you to the beginning of the field and the end key to the 
  1032. last character of the contents.
  1033.  
  1034. The SysOp field is used when WaterGate has to write special replies, 
  1035. for example for AreaFix. More about that later. Let's go to the next 
  1036. field.
  1037.  
  1038. WaterGate Manual       System Configuration                 Page 19
  1039. ---------------------------------------------------------------------
  1040. System path
  1041. -----------
  1042.  
  1043. You have to enter the path to the WaterGate databases here, in our 
  1044. example C:\WTRGATE. This path information is stored in the WaterGate 
  1045. configuration database. It finds this database by looking at the 
  1046. environment variable WTRGATE. The path in this field will be used to 
  1047. find the other databases after having read the configuration file. 
  1048. So:
  1049.  
  1050. WTRGATE=C:\WTRGATE ->
  1051. WTRCFG.TDB ->
  1052. System Path ->
  1053. The other *.TDB files
  1054.  
  1055. AreaFix and NewsFix
  1056. -------------------
  1057.  
  1058. The next two fields are the names for AreaFix and newsfix, programs 
  1059. integrated in WTRGATE.EXE. A user can write a message to these 
  1060. programs to connect and disconnect areas and to change settings that 
  1061. are personal to that user. The names you enter in these fields are 
  1062. the names your users have to use when writing a message to them. 
  1063. AreaFix is used for FidoNet and newsfix is used for UUCP. It is 
  1064. conventional to use mixed case names for FidoNet ("AreaFix") and 
  1065. flat, lower case names for UUCP ("newsfix"). We will get back to 
  1066. these names later and assume you are using the default names, so 
  1067. there is no reason to change them here.
  1068.  
  1069. Duplicates
  1070. ----------
  1071.  
  1072. On to the next two fields that have to do with dupe checking. 
  1073. WaterGate is able to identify two messages as being identical 
  1074. (duplicates) and then only distribute the first. This prevents 
  1075. wasting disk space and transport time.
  1076.  
  1077. At this moment, the method used to identify duplicates inside the 
  1078. WaterGate program is not very robust. We therefore advise big systems
  1079. to disable duplicate checking until we have implemented a better 
  1080. algorithm. (At this moment, one database with a maximum of 16000 
  1081. entries is used to keep track of all FidoNet and UUCP messages. No 
  1082. way is this enough for a system receiving packets via satellite. 
  1083. Future algorithms will not only separate Fido and UUCP dupes, but 
  1084. also do message/reply id bridging and allow a bigger duplicates 
  1085. database).
  1086.  
  1087. The first field you can set for the duplicates checking is a "toggle"
  1088. field. Toggles are used to select from two or more predefined 
  1089. options, in this case ON and OFF. You can only use enter to toggle 
  1090. the setting. The one in upper case is the current selection.
  1091.  
  1092. The next field is a numeric input field, where (in this case) you can
  1093. input the number of duplicates WaterGate has to "remember". The 
  1094. number in our example window is 10000, which means WaterGate will 
  1095. identify two duplicates, even if 9999 messages are sent in between. 
  1096. WaterGate Manual       System Configuration                 Page 20
  1097. ---------------------------------------------------------------------
  1098. The maximum number you can enter here is 16000.
  1099.  
  1100. When a duplicate message is found, it will be destroyed by default. 
  1101. Later in the configuration, you can also create a message base to 
  1102. put the duplicates in.
  1103.  
  1104. Max. open handles
  1105. -----------------
  1106.  
  1107. Because opening and closing a file takes a lot of time, WaterGate 
  1108. tries keep an outgoing mail bundle open as long as possible. If you 
  1109. allow it to use more file handles, you can drastically reduce the 
  1110. number of open/close actions.
  1111.  
  1112. By default, WaterGate tries to open up to 8 handles for outgoing mail
  1113. packets. If you don't export mail to other computers, then you can 
  1114. reduce this setting to 1. If you do export mail, try increasing this 
  1115. number by 1 for each node. WaterGate is capable of using up to 100 
  1116. file handles. If you have more nodes than handles, files are closed 
  1117. in a priority order: the more mail a node receives, the less often 
  1118. its packets are opened and closed.
  1119.  
  1120. Depending on its configuration, WaterGate needs up to 10 file handles
  1121. for its own use, the system will use a few too, so make sure you have
  1122. a matching number in your CONFIG.SYS:
  1123.  
  1124. FILES=20+Nodes+10
  1125.  
  1126. Cache .TDB files
  1127. ----------------
  1128.  
  1129. WaterGate is able to copy its databases containing users and areas 
  1130. into XMS memory, decreasing disk access during a run. To activate 
  1131. this option, toggle "Cache .TDB files" to ON.
  1132.  
  1133. At startup, WaterGate will copy its databases into XMS memory, up to 
  1134. the amount of available memory. WaterGate has no other use for XMS 
  1135. memory besides caching its databases and shelling.
  1136.  
  1137. Oversized path
  1138. --------------
  1139.  
  1140. When WaterGate encounters a message bigger than it can handle, it 
  1141. will use the 'Oversized' path to store it for the SysOp to look at. 
  1142. The maximum size of a message is limited by the amount of free 
  1143. memory, which should be approximate 200 kilobytes.
  1144.  
  1145. If you use a swap file (see below), WaterGate will only use the 
  1146. oversized directory if the swap file gets full as well.
  1147.  
  1148. Log file path
  1149. -------------
  1150.  
  1151. Use the 'Log file path' to specify a complete path and file name for 
  1152. WaterGate's log file. This file is used by both WaterGate and WtrUtil
  1153. to log run-time actions.
  1154. WaterGate Manual       System Configuration                 Page 21
  1155. ---------------------------------------------------------------------
  1156. This path is also used to write the statistics file. This file takes 
  1157. the same name as the log file, but with the extension .STA. So, if 
  1158. your log file is called WTRGATE.LOG, the statistics log is named 
  1159. WTRGATE.STA and put in the same directory as the log file.
  1160.  
  1161. Use swap file?
  1162. --------------
  1163.  
  1164. WaterGate is able to use a swap file as additional memory. If it runs
  1165. out of normal memory to store a message in, it will swap all lines 
  1166. out of normal memory into the swap file. This frees up a lot of 
  1167. normal memory, allowing another couple of thousand lines to be read 
  1168. again. If it fills up again, it flushes these lines to the swap file 
  1169. as well, and so on. You can limit this by configuring a maximum swap 
  1170. file size.
  1171.  
  1172. Since WaterGate is not capable of using XMS memory to store messages,
  1173. you might be able to setup the swap file on a RAM-drive and let the 
  1174. RAM-drive use XMS memory. In this case, though, the swap file is 
  1175. limited by the available memory. It may be better to put the swap 
  1176. file on hard disk, so you can process those 1 megabyte+ news and 
  1177. FTP-mail messages easily.
  1178.  
  1179. You can use the toggle 'Use swap file?' to switch the swap file 
  1180. usage on and off. It is on by default.
  1181.  
  1182. Swap file path
  1183. --------------
  1184.  
  1185. Since you might want to put the swap file on a RAM-drive, you can 
  1186. enter the complete path plus filename for the swap file in this 
  1187. field. WaterGate will create the file by itself and delete it after 
  1188. running.
  1189.  
  1190. Swap file size
  1191. --------------
  1192.  
  1193. To set a maximum size for the swap file (you don't want it to use up 
  1194. all of your hard disk space, do you?), you must enter a limit in 
  1195. megabytes here. The default is 2 megabytes. WaterGate will not use 
  1196. the space unless necessary. You can check the swap file usage in the 
  1197. log file.
  1198.  
  1199. The main use for the limit is when putting the swap file on a 
  1200. RAM-drive. Depending on your mail configuration, between 1 and 2 
  1201. megabytes should be enough for the swap file. Let us know if you 
  1202. ever have to process bigger files (FTP-mail).
  1203.  
  1204. Time slicing
  1205. ------------
  1206.  
  1207. WaterGate supports Windows, OS/2 and DesqView by giving up time 
  1208. slices to make sure it WtrGate.exe or WtrUtil.exe doesn't hog the 
  1209. CPU.
  1210.  
  1211. If you are experiencing problems with the time slicing support, then 
  1212. WaterGate Manual       System Configuration                 Page 22
  1213. ---------------------------------------------------------------------
  1214. you can switch it off by setting this toggle to NO. Otherwise leave 
  1215. it to YES.
  1216.  
  1217. Minimum disk free
  1218. -----------------
  1219.  
  1220. You can tell WaterGate to monitor the free space on one or more of 
  1221. your hard drives. The space will be checked regularly by wtrgate.exe 
  1222. while it is working on your messages.
  1223.  
  1224. If the free spaces runs below the limit set in this field, then 
  1225. WtrGate will stop.
  1226.  
  1227. Drives to check
  1228. ---------------
  1229.  
  1230. You can select the drives you want to have checked for free disk 
  1231. space in this field. Simply type the drive letters. For example, 
  1232. "CDT" to check drives C:, D: and T:.
  1233. WaterGate Manual       Setting up the Fido system           Page 23
  1234. ---------------------------------------------------------------------
  1235. Setting up the Fido system
  1236. --------------------------
  1237.  
  1238. This part tells you in detail how to set up the FidoNet side of your 
  1239. WaterGate system. Other chapters will teach you how to add users 
  1240. (uplinks, nodes, points, etc.) and areas (echomail and netmail).
  1241.  
  1242. Fido AKAs
  1243. ---------
  1244.  
  1245. Because WaterGate needs to know who you are, enter the "Fido AKAs" 
  1246. sub-menu from the "System Configuration" menu. Here you can enter up 
  1247. to 100 different Fido addresses. The following screen will be 
  1248. presented to you.
  1249.  
  1250.     + (100) -------------------------+
  1251.     |           Fido AKAs            |
  1252.     +--------------------------------+
  1253.     ||2:280/803                 1017 |
  1254.     ||60:100/1                     0 |
  1255.     ||0                            0 |
  1256.     ||0                            0 |
  1257.     ||0                            0 |
  1258.     ||0                            0 |
  1259.     ||0                            0 |
  1260.     ||0                            0 |
  1261.     ||0                            0 |
  1262.     |v0                            0 |
  1263.     +--------------------------------+
  1264.  
  1265. We call these type of screens "Lists". They look very similar to 
  1266. menus and the little difference is the number in the top left corner 
  1267. of the window and the arrows on the line at the left (it was changed 
  1268. to a "v" here). The number tells you how many items are in the list. 
  1269. If there are more items in the list than fit in the window, you can 
  1270. scroll through the list. The arrows at the top and bottom of the 
  1271. line will tell you if there are more items in a certain direction. 
  1272. Because you can only see an arrow at the bottom of the line, we must 
  1273. be near the top and there are more items below.
  1274.  
  1275. You can use a lot of keys to scroll through the list, including the 
  1276. cursor keys Up, Down, PgUp, PgDn, Ctrl+PgUp, and Ctrl+PgDn.
  1277.  
  1278. Some lists contain wider lines than fit in the window. In that case, 
  1279. you can also scroll horizontally using the cursor keys Left and Right
  1280. and the Ctrl+Left, Ctrl+Right, Home, and End keys. There will also be
  1281. arrow indicators on these oversized lines. We will get to some of 
  1282. these lists later. Let's get back to the AKAs.
  1283.  
  1284. In this list you enter all the Fido addresses (AKAs) this system must
  1285. be know as. Don't start typing all the AKAs at once, but add some 
  1286. more as you configure more and more networks.
  1287.  
  1288. The first AKA you enter here will be your main Fido address. 
  1289. Normally, the program will try to use a system AKA that matches 
  1290. closely to the network it has to send a message to. The main AKA is 
  1291. WaterGate Manual       Setting up the Fido system           Page 24
  1292. ---------------------------------------------------------------------
  1293. used when it is not possible to find a proper match, or on other 
  1294. occasions, such as when the system has to send a message to you, the 
  1295. SysOp.
  1296.  
  1297. Optionally, you can specify a Fakenet or Pointnet number. Only use 
  1298. this if you have (or are) a point using old 3D Fidonet software, 
  1299. which can't handle complete point addressing directly.
  1300.  
  1301. For those of you who don't know what a pointnet is: if a mailer is 
  1302. incapable of handling 4D (zone:net/node.point) addresses, but only 
  1303. 3D (zone:net/node) addresses, it would be very inconvenient to have 
  1304. to use node numbers for your points instead. Pointnets have been 
  1305. invented to solve this. A point with an address 2:280/802.33 would 
  1306. then be translated to 2:1017/33 if your pointnet for that AKA is 
  1307. 1017.
  1308.  
  1309. Note: if you want WaterGate to use the pointnet for a certain point, 
  1310. you have to define that user in the userbase with the pointnet 
  1311. address as his AKA. More on this later. Once again back to the list.
  1312.  
  1313. The left side contains the AKA and the right side the pointnet 
  1314. number. If you want to change a line, press Enter and you will be 
  1315. presented a little (two line) window. You can change the AKA at the 
  1316. top line and enter the pointnet number at the bottom line.
  1317.  
  1318. Since WaterGate supports 5D addresses, you can enter your fido AKA 
  1319. as zone:net/node.point@domain. The minimum is zone:net/node, though.
  1320. WaterGate Manual       Setting up the Fido system           Page 25
  1321. ---------------------------------------------------------------------
  1322. Fido Settings
  1323. -------------
  1324.  
  1325. The next option from the System Settings menu brings you to a screen 
  1326. like this:
  1327.  
  1328.     +------------------------------------------------------+
  1329.     | Inbound dir 1      C:\INBOUND\                       |
  1330.     | Security           on OFF                            |
  1331.     |                                                      |
  1332.     | Inbound dir 2                                        |
  1333.     | Security           on OFF                            |
  1334.     |                                                      |
  1335.     | Outbound dir       E:\NODE\OUT\                      |
  1336.     |                                                      |
  1337.     | Origin 1           Life at the end of the impossible |
  1338.     | Origin 2                                             |
  1339.     | Fido System        binkley FRONTDOOR d'bridge        |
  1340.     | D'bridge queue     E:\DBRIDGE\QUEUE\                 |
  1341.     | Mailer rescan file C:\FD\FDRESCAN.NOW                |
  1342.     | Editor rescan file C:\FD\FMRESCAN.NOW                |
  1343.     | Max *.MSG  length  12000                             |
  1344.     | Max Squish length  12000                             |
  1345.     | Max JAM    length  12000                             |
  1346.     | Max *.PKT  length  0                                 |
  1347.     | Default groups     A                                 |
  1348.     | Arcmail names      ARCMAIL hex all                   |
  1349.     +------------------------------------------------------+
  1350.  
  1351. Inbound directories
  1352. -------------------
  1353.  
  1354. When Fidonet mail bundles arrive at your system, by use of a Fido 
  1355. mailer such as FrontDoor or Binkley, they are put in a special 
  1356. holding directory, also known as the "Inbound" directory.
  1357.  
  1358. WaterGate supports up to two such directories. Each directory has a 
  1359. switch to toggle security on or off. When security is ON for an 
  1360. inbound directory, mail bundles are only decompressed if they were 
  1361. sent by a system that is configured as a user on our system.
  1362.  
  1363. Second, decompressed mail bundles are checked to ensure they contain 
  1364. the same password as defined for the user sending the bundle. If no 
  1365. password is defined for a node, the password within the mail bundle 
  1366. is ignored.
  1367.  
  1368. A mail bundle from an unknown node will be renamed to *.UNK and 
  1369. logged. Mail bundles with a wrong password are renamed to *.PWD and 
  1370. logged as well.
  1371.  
  1372. Outbound directory
  1373. ------------------
  1374.  
  1375. New mail bundles created for Fido style nodes that this node sends 
  1376. mail to are put in the "Outbound" directory. For BinkleyTerm 
  1377. systems, this is a Binkley 2.50 5D compatible outbound directory, 
  1378. WaterGate Manual       Setting up the Fido system           Page 26
  1379. ---------------------------------------------------------------------
  1380. with support for Binkley point directories.
  1381.  
  1382. WaterGate tries to create Binkley sub-directories when needed. For 
  1383. FrontDoor systems, all outgoing mail bundles are stored in this 
  1384. directory.
  1385.  
  1386. Since The TBBS mailer TIMS also uses the Binkley outbound style 
  1387. directories, you can have WaterGate and TIMS operate on the same 
  1388. directories as well. WaterGate does not _yet_ check for TIMS busy 
  1389. files yet, nor does it create them. It does do this for Binkley, 
  1390. though.
  1391.  
  1392. Just as TIMS and BinkleyTerm are almost the same, you can select 
  1393. FrontDoor if you are using InterMail.
  1394.  
  1395. Warning: always make sure that WaterGate's primary system AKA (the 
  1396. first one in the list) is also the primary AKA that the mailer uses! 
  1397. If you fail to do so, the wrong users can get the wrong archives!!
  1398.  
  1399. Origin lines
  1400. ------------
  1401.  
  1402. You can define up to two default Origin lines, which are attached to 
  1403. messages exported from your local message bases without one, or when 
  1404. messages are converted from UUCP to Fidonet. You can define a custom 
  1405. origin line for each area, or choose to use one of these default 
  1406. lines.
  1407.  
  1408. Fido system
  1409. -----------
  1410.  
  1411. Choose the type of mailer you are using. Possible systems include 
  1412. BinkleyTerm 2.50 and up, FrontDoor, and d'Bridge. All three of these 
  1413. programs employ a different way to store information on outgoing 
  1414. files. BinkleyTerm expects information files in its outbound 
  1415. directories; FrontDoor uses the netmail messages directory; and 
  1416. d'Bridge has a special queue path where it looks for its information.
  1417. If you are using d'Bridge, specify that path in the "d'Bridge Queue" 
  1418. option.
  1419.  
  1420. Note that this selection changes WaterGate's behavior drastically. 
  1421. Don't forget to set this switch properly, or you will have a very 
  1422. hard time processing your inbound and creating a proper and 
  1423. compatible outbound!
  1424.  
  1425. Mailer rescan file
  1426. ------------------
  1427.  
  1428. Your mailer will have to rescan its list of outgoing files and 
  1429. messages after new mail has been set ready by WaterGate. To inform 
  1430. the mailer of this, WaterGate can create or 'touch' a special flag 
  1431. file. All you have to do is enter the proper path plus filename. The 
  1432. following files are used for the different systems:
  1433. WaterGate Manual       Setting up the Fido system           Page 27
  1434. ---------------------------------------------------------------------
  1435. d'Bridge    DBRIDGE.RSN
  1436. FrontDoor   FDRESCAN.NOW
  1437. InterMail   IMRESCAN.NOW
  1438.  
  1439. Editor rescan file
  1440. ------------------
  1441.  
  1442. If you are in your netmail editor while WaterGate is importing new 
  1443. netmail messages in the background or on another network machine, 
  1444. then it would be nice if your editor was informed about newly 
  1445. imported netmail messages.
  1446.  
  1447. WaterGate does this by setting a flag file. For FrontDoor's editor 
  1448. FM for example, you could have WaterGate set the flag file 
  1449. FMRESCAN.NOW.
  1450.  
  1451. Max length settings
  1452. -------------------
  1453.  
  1454. Because old Fido mail processors have trouble processing messages 
  1455. over 12Kb in size, WaterGate can split messages that exceed some 
  1456. maximum message length. Set this limit using the "Max *.MSG length" 
  1457. option. This limit is used to split messages when importing into the 
  1458. *.MSG message base and when exporting to a .PKT file!
  1459.  
  1460. Although both the Squish and JAM specifications allow for unlimited 
  1461. message sizes, most editors have trouble reading messages that are 
  1462. over 64Kb in size. If you want WaterGate to split the messages when 
  1463. importing them, enter a maximum message size, or use 0 to ignore the 
  1464. message size and disable message splitting.
  1465.  
  1466. Note: These are approximate values. WaterGate checks them after 
  1467. having added a line of text, so there might be a slight deviation in 
  1468. the final message size.
  1469.  
  1470. When packing outgoing messages for other nodes, WaterGate will group 
  1471. them in .PKT files. You can specify a maximum size for those .PKT 
  1472. (Max *.PKT length) files before WaterGate creates a new one. During 
  1473. buildup, these .PKT files are named *.QQQ. At the end of the run they
  1474. are renamed to .PKT one at a time and then added to the final 
  1475. archive.
  1476.  
  1477. Default groups
  1478. --------------
  1479.  
  1480. You can give each node access to a number of groups. You will soon 
  1481. decide which groups will contain the echomail areas and which will 
  1482. not.
  1483.  
  1484. When creating a new Fido style user, you have to set the groups he or
  1485. she is allowed to access. Because you don't want to set these every 
  1486. time, you can enter a default list of groups in this screen.
  1487.  
  1488. After pressing enter, you are presented with the standard group 
  1489. editing method. The groups are listed on the left side of the screen 
  1490. (complete with description and read-only flag). You can press the 
  1491. WaterGate Manual       Setting up the Fido system           Page 28
  1492. ---------------------------------------------------------------------
  1493. Insert key to add new groups, or use the Delete key to remove one. 
  1494. After pressing Insert, a new list pops up on the right side of the 
  1495. screen.
  1496.  
  1497. Select the group you want to add with the cursor keys and then press 
  1498. Enter. If you change your mind and don't want to add a group, simply 
  1499. press Escape. When you are done changing the groups, you have to 
  1500. press Escape or F10 to return to this screen again.
  1501.  
  1502. More advanced users can also use tagging to add or remove more than 
  1503. one group at a time. Use the F5, F6, and F7 keys for tagging. F5 
  1504. selects or deselects one item; with F6 you can select all the lines 
  1505. that match a certain search string (an empty string matches all); 
  1506. and F7 deselects all lines that match a certain search string.
  1507.  
  1508. ArcMail names
  1509. -------------
  1510.  
  1511. When creating outgoing Fido mail archives, WaterGate can create mail 
  1512. bundles that use the following name extension conventions:
  1513.  
  1514. ArcMail: (day of week) + 0..9
  1515. Hex:     (day of week) + 0..9, A..F
  1516. All:     (day of week) + 0..9, A..Z
  1517.  
  1518. Ensure that the software your up- and downlinks are using can handle 
  1519. the format you specify. The default setting is ArcMail, which results
  1520. in archive bundles with names like .SU0, .TH3, .FR4, etc.
  1521.  
  1522. WaterGate keeps track of the digit or letter it last used for each 
  1523. user. If the .SU0 file has been sent, for example, WaterGate will 
  1524. create a .SU1 file instead of a new .SU0 file.
  1525. WaterGate Manual       Setting up the Fido system           Page 29
  1526. ---------------------------------------------------------------------
  1527. Fido Message Bases
  1528. ------------------
  1529.  
  1530. If you select the Fido Message bases option from the System Settings 
  1531. menu, you will be presented a screen that looks like this. This 
  1532. screen contains all the important settings related to the local 
  1533. message bases.
  1534.  
  1535.     +-----------------------------------------+
  1536.     | Auto link         OFF on                |
  1537.     | Strip SeenBy      off ON                |
  1538.     | Replace Tear      off ON                |
  1539.     |                                         |
  1540.     | Netmail type      MSG squish jam        |
  1541.     | Netmail path      D:\NODE\NET\          |
  1542.     | Decode files      no ON IMPORT          |
  1543.     | Files patch       D:\DECODED\NET\       |
  1544.     |                                         |
  1545.     | Badmail type      NONE msg squish jam   |
  1546.     | Badmail path                            |
  1547.     | Dupemail type     NONE msg squish jam   |
  1548.     | Dupemail path                           |
  1549.     |                                         |
  1550.     | Default number    200                   |
  1551.     | Default days      5                     |
  1552.     | Auto Create Type  NONE msg squish jam   |
  1553.     | Default new path  E:\NODE\NEW\          |
  1554.     +-----------------------------------------+
  1555.  
  1556. Auto Link
  1557. ---------
  1558.  
  1559. Toggle "Auto Link" to ON if you want WaterGate to link messages in 
  1560. all areas that received new mail during the mail toss. You might 
  1561. want to turn this off and save time if you toss a lot of small mail 
  1562. bundles containing only a few new messages. To link your message 
  1563. areas, you can then use WaterUtil's 'Link All' option.
  1564.  
  1565. Strip SEEN-BY
  1566. -------------
  1567.  
  1568. Toggle "Strip SeenBy" to ON if you want to save harddisk space by NOT
  1569. importing SEEN-BY lines into your message base. Remember that 
  1570. re-exporting messages with incomplete SEEN-BY lines is often 
  1571. considered a capital crime.
  1572.  
  1573. Replace Tearline
  1574. ----------------
  1575.  
  1576. The "Replace Tear" option is only available for registered users, the
  1577. setting is ignored for the unregistered version. If you set to ON, 
  1578. the program will replace all tear lines it finds in locally generated
  1579. messages with its own. Tear-lines are also added to messages that are
  1580. converted by WaterGate from UUCP to Fidonet.
  1581.  
  1582. The result is something like:
  1583. WaterGate Manual       Setting up the Fido system           Page 30
  1584. ---------------------------------------------------------------------
  1585. --- WtrGate v1.00 Unreg
  1586. --- WtrGate+ v1.00
  1587.  
  1588. Netmail message base
  1589. --------------------
  1590.  
  1591. Since a Netmail message base is required by WaterGate, enter a full 
  1592. path to it under "Netmail path". You can choose to make it a *.MSG, 
  1593. Squish, or JAM base. Use "Netmail type" to choose your preferred 
  1594. type.
  1595.  
  1596. If you set it to *.MSG, the path has to point to a directory. If you 
  1597. set it to Squish or JAM, the path has to include the message base 
  1598. name without an extension.
  1599.  
  1600. If you're using FrontDoor as your Fido system type, then a *.MSG 
  1601. directory is required! Also, for compatibility with many other 
  1602. programs, usage of a *.MSG netmail path is advised.
  1603.  
  1604. Notice that you DO NOT have to create an Area Record (Area 
  1605. definitions from the main menu) for the netmail area, nor the 
  1606. badmail or dupes message areas! Doing so might result in operational 
  1607. problems.
  1608.  
  1609. Decode files
  1610. ------------
  1611.  
  1612. If an e-mail messages contains an UU-encoded, XX-encoded or MIME 
  1613. encoded file, then WaterGate can automatically decode this file, save
  1614. it on your harddisk and store the remainder of the message. This 
  1615. option is currently only available for *.MSG bases.
  1616.  
  1617. If you set this option to ON IMPORT, then WaterGate will decode files
  1618. from messages that are imported into you *.MSG netmail area and are 
  1619. addressed to one of your system AKAs. All messages for downlinks are 
  1620. left as they are for the moment. Decoding those files means routing 
  1621. them as well and this is not built in yet.
  1622.  
  1623. The decoded files will be written to the path given in "Files path".
  1624.  
  1625. Badmail message base
  1626. --------------------
  1627.  
  1628. If you want to keep track of messages that somehow go wrong, then 
  1629. enable the Badmail message base. Use the "Badmail type" option to 
  1630. enable this option or select NONE to disable it. Make sure you enter 
  1631. a correct path under "Badmail path". WaterGate uses the "Default 
  1632. Number" and "Default Days" settings to clean up your Badmail.
  1633.  
  1634. Dupes message base
  1635. ------------------
  1636.  
  1637. If WaterGate finds a duplicate message, it deletes it by default. If 
  1638. you want to keep track of these messages, you can setup a message 
  1639. base to put them in. Just as with netmail and badmail you have to 
  1640. set a type and enter a path.
  1641. WaterGate Manual       Setting up the Fido system           Page 31
  1642. ---------------------------------------------------------------------
  1643. Default number and days
  1644. -----------------------
  1645.  
  1646. When a new area is created, these two values are put in the "Fido 
  1647. limit" and "Fido age" fields. The first is the maximum number of 
  1648. messages you want to have in a message base and the second is the 
  1649. maximum age of a message. If the message is older, it will be removed
  1650. when cleaning the message base.
  1651.  
  1652. Auto create type and default path
  1653. ---------------------------------
  1654.  
  1655. If a message arrives in an unknown area and the user that sent it has
  1656. the "Create new areas" option in his user record set to YES, 
  1657. WaterGate automatically creates an area record in the areabase.
  1658.  
  1659. If you want that area as a message base later on, you have to enter 
  1660. the path to the message base and set the correct type. The path 
  1661. might be a lot of typing work, so you can enter the default path for 
  1662. the message base in the "Default new path" field.
  1663.  
  1664. If you also want to have a message base created for it (very handy 
  1665. for small systems, like points, where you know that the new areas 
  1666. are OK), you can set the message base type for these areas in the 
  1667. "Auto Create Type" field.
  1668.  
  1669. Because you need a message base name for Squish and JAM, WaterGate 
  1670. automagically creates one for you. Since the first eight characters 
  1671. of an area are not unique (and completely useless for Usenet areas 
  1672. like ALT.BBS.SOMETHING, where you have the dots), WaterGate creates 
  1673. a magic number. This is the CRC32 value of the complete string that 
  1674. represents the area-name, padded with spaces to the maximum length. 
  1675. This number is used as the filename (Squish, JAM) or directory name 
  1676. (*.MSG) for that message base.
  1677.  
  1678. The only disadvantage of this magic number is that the real areaname 
  1679. cannot be determined from the base-name, other than by consulting 
  1680. the configuration program. You can manually change the name of the 
  1681. message base afterwards, although WtrConf will not (yet) rename the 
  1682. message base files automatically. But if you use WtrConf to export a 
  1683. Squish config file (also good for JAM bases!) and feed that to your 
  1684. editor, you don't have to know the message base name at all!
  1685. WaterGate Manual       Setting up the Fido system           Page 32
  1686. ---------------------------------------------------------------------
  1687. Fido Compression Programs
  1688. -------------------------
  1689.  
  1690. Select "Fido Compression Programs" from the System Settings sub-menu 
  1691. to enter a screen that looks like this:
  1692.  
  1693.     +---------------------------------------------+
  1694.     | ARC     PKPAK -OCT A                        |
  1695.     | UNARC   PKUNPAK /R                          |
  1696.     | ARJ     ARJ A -E                            |
  1697.     | UNARJ   ARJ E -N                            |
  1698.     | LZH     LHA A /M                            |
  1699.     | UNLZH   LHA E                               |
  1700.     | PAK     PAK A                               |
  1701.     | UNPAK   PAK E /WN                           |
  1702.     | ZIP     PKZIP -A                            |
  1703.     | UNZIP   PKUNZIP -O                          |
  1704.     | ZOO     ZOO -Add                            |
  1705.     | UNZOO   ZOO -Extract                        |
  1706.     | RAR     RAR A                               |
  1707.     | UNRAR   RAR E                               |
  1708.     | OP1                                         |
  1709.     | GUS                                         |
  1710.     | Default arc arj lzh pak ZIP zoo rar op1 pkt |
  1711.     +---------------------------------------------+
  1712.  
  1713. WaterGate is capable of recognizing 7 of the most widely used 
  1714. compression programs within Fidonet: ARC, ARJ, LZH, PAK, ZIP, ZOO 
  1715. and RAR.
  1716.  
  1717. When it encounters compressed Fidomail bundles, it tries to start 
  1718. the correct decompression program. If it is unable to recognize the 
  1719. compression method, it checks whether a GUS (General Unpack Shell) 
  1720. is defined and lets the GUS have a try at it.
  1721.  
  1722. Use this screen to enter the correct program names and options for 
  1723. each compression and decompression program. A special option is 
  1724. 'OP1', which you can use to compress your mail using a program 
  1725. unknown to WaterGate. There is, of course, no way for WaterGate to 
  1726. recognize and decompress this sort of archive.
  1727.  
  1728. Use the last line to select a Default type for WaterGate to use in 
  1729. situations when it has to pack messages for an undefined node, for 
  1730. example when sending crash mail messages. This is also the default 
  1731. type for newly created user records.
  1732. WaterGate Manual       Setting up the Fido system           Page 33
  1733. ---------------------------------------------------------------------
  1734. Fido AreaFix Forwarding
  1735. -----------------------
  1736.  
  1737. WaterGate is capable of AreaFix forwarding for both Fidonet and UUCP.
  1738. When a user requests an area that is not available at your system, 
  1739. WaterGate can ask one of your uplinks to start sending that area.
  1740.  
  1741. Notice that there is a separate section about newsfix forwarding and 
  1742. a section that explains  how to use AreaFix and newsfix.
  1743.  
  1744. When WaterGate does this, the area is created automatically and both 
  1745. the requesting user and the uplink system are connected at once.
  1746.  
  1747. The areas that can be requested dynamically are stored in one or more
  1748. listings on disk. You tell WaterGate what the node number for your 
  1749. uplink is and which file to check for area names. You can define up 
  1750. to 50 listings for Fidonet and the same amount for UUCP.
  1751.  
  1752. You can configure the Areafix forwarding by selecting Fido areafix 
  1753. Forwarding from the System Configuration menu. You can then select 
  1754. one of the ten entries and press enter to edit it. You will see the 
  1755. following screen to edit an entry.
  1756.  
  1757.     +------------------------------------------+
  1758.     | Address       : 2:280/801                |
  1759.     | Unconditional : NO yes                   |
  1760.     | Arealist path : C:\BBS\AREALIST.BBS      |
  1761.     | Arealist type : AREAS.BBS name list      |
  1762.     | Area manager  : AREAFIX                  |
  1763.     | Password      : highbrazil               |
  1764.     | Group         : A                        |
  1765.     | Add "+"       : NO yes                   |
  1766.     +------------------------------------------+
  1767.  
  1768. Specify the Fido address of each uplink system in the 'Address' 
  1769. field. When you flag an uplink as 'unconditional' the request is 
  1770. always forwarded to this node, and WaterGate makes no attempt to 
  1771. search the specified area list.
  1772.  
  1773. Specify the full path to the area listing in the "Arealist path". 
  1774. Then select the type of listing: the AREAS.BBS type follows 
  1775. 'standard' areas.bbs convention, while for the 'Name list' each line 
  1776. in the file has to contain a single area name.
  1777.  
  1778. Select the program name of the Area Manager program on your uplink 
  1779. system. Most should be capable of understanding the default 
  1780. 'AreaFix'. The password is used when writing the AreaFix message.
  1781.  
  1782. Specify to which group the new area is to be added. WaterGate will 
  1783. only scan the lists for groups to which the requesting user has 
  1784. access. Adding a '+' is used to support AreaFix programs that need 
  1785. one for each requested area. Instead of just listing the requested 
  1786. areas, each one has a '+' added in front.
  1787. WaterGate Manual       Setting up the UUCP system           Page 34
  1788. ---------------------------------------------------------------------
  1789. Setting up the UUCP System
  1790. --------------------------
  1791.  
  1792. This chapter explains in detail how to set up the UUCP side of your 
  1793. WaterGate system. Other chapters will teach you how to add systems 
  1794. (users) and newsgroups (areas).
  1795.  
  1796. If you don't have a UUCP connection, you can still use this program 
  1797. perfectly well without entering any options in this section.
  1798.  
  1799. UUCP settings
  1800. -------------
  1801.  
  1802. If you select "UUCP settings" from the System Settings menu, you 
  1803. will be presented with the following screen:
  1804.  
  1805. WaterGate Manual       Setting up the UUCP system           Page 35
  1806. ---------------------------------------------------------------------
  1807.     +----------------------------------------------------+
  1808.     | Organization        Waterline Software Development |
  1809.     | UUCP SPOOL path     C:\SPOOL\                      |
  1810.     | System UUCP name    water                          |
  1811.     | World registered    NO yes                         |
  1812.     | Smart host          seunet                         |
  1813.     | Backbone            Berkeley.EDU                   |
  1814.     | System domains      wsd.wline.se                   |
  1815.     |                     admin.wline.se                 |
  1816.     |                                                    |
  1817.     |                                                    |
  1818.     |                                                    |
  1819.     |                                                    |
  1820.     | Default groups                                     |
  1821.     | Time zone           GMT+1                          |
  1822.     | Maximum .DAT length 200000                         |
  1823.     | Undeliverable mail  netmail BOUNCE                 |
  1824.     | Bounce small        no YES                         |
  1825.     | Mail grade          A                              |
  1826.     | News grade          Z                              |
  1827.     | UUCP filenames      NORMAL no bitmask              |
  1828.     +----------------------------------------------------+
  1829.  
  1830. First of all, who are you? WaterGate will append an "Organization" 
  1831. line to all messages it sends into Usenet. This can be a message 
  1832. gated from FidoNet or a message created by the system itself. You 
  1833. can enter a short line describing your organization or company.
  1834.  
  1835.     Organization: Sweet Bug & Company, Holland
  1836.  
  1837. The spool directory system
  1838. --------------------------
  1839.  
  1840. The spool directory is a place to store outgoing and incoming files 
  1841. for UUCP systems. Each system requires its own spool sub-directory 
  1842. to store the files destined for or received from that system.
  1843.  
  1844. The UUCICO program searches for .CMD files in this directory. A .CMD 
  1845. file holds the names of the files to transfer.
  1846.  
  1847. News and mail is sent in .DAT files, where multiple news messages go 
  1848. in one file (called a batch) and mail messages are put in separate 
  1849. files.
  1850.  
  1851. The news batches can also be compressed using COMPRESS, COMP430D, or 
  1852. GZIP and can have a special header on top of that, called a 
  1853. "cunbatch" header.
  1854.  
  1855. The .DAT files contain all the data and the .XQT files contain the 
  1856. processing statements and tells us whether it is a mail message or a 
  1857. news batch. A program called XQT will then run the correct program 
  1858. to process these files.
  1859.  
  1860. Since WaterGate is compatible with the spool directory structure and 
  1861. has to create mail and news batches for systems that process them as 
  1862. described above, WaterGate creates .DAT, .XQT, and .CMD files.
  1863. WaterGate Manual       Setting up the UUCP system           Page 36
  1864. ---------------------------------------------------------------------
  1865. The UUCICO does one thing more with .DAT and .XQT files when sending 
  1866. them: the receiving system renames them to .D and .X, so they can't 
  1867. overwrite any outgoing files. Since the .CMD file is only a command 
  1868. file for UUCICO, it is not transferred.
  1869.  
  1870. When WtrGate (the program) runs, it searches the userbase for UUCP 
  1871. style users, then checks if there is a sub-directory in this spool 
  1872. directory for that user and creates one if it doesn't exist already. 
  1873. It then searches for .X files and reads these. According to the 
  1874. contents of the .X file it then processes the .D file.
  1875.  
  1876. If something goes wrong during processing, or if it can't file the 
  1877. .D file, it renames the .X and .D files to .BAX and .BAD.
  1878.  
  1879. You have to put the spool directory path in the second field of the 
  1880. screen. Don't append any UUCPname whatsoever, just enter the path up 
  1881. and until the directory that is usually called SPOOL, as you can see 
  1882. in the example screen grab.
  1883.  
  1884. Note that the TBBS option module "PIMP" is not compatible with this 
  1885. spool directory structure, although it is capable of transferring 
  1886. files using the UUCP protocol.
  1887.  
  1888. UUCP name
  1889. ---------
  1890.  
  1891. The next field to fill in is your system's UUCPname. You don't have 
  1892. to create yourself in the userbase (just as you don't create a Fido 
  1893. style user with your AKA), but WaterGate needs to know your UUCPname 
  1894. during processing and it puts it in the files it creates in the 
  1895. spool directories.
  1896.  
  1897. In our case, our UUCPname is "wsd", which has to be typed in using 
  1898. the correct case (capital letters or not). The maximum length of 
  1899. this name is 12 characters, of which only 7 are significant.
  1900.  
  1901. Domain addresses
  1902. ----------------
  1903.  
  1904. Next are your domain addresses. This is the last part of your e-mail 
  1905. address, behind the @ sign. For me (ramon@wsd.wline.se) it is 
  1906. "wsd.wline.se". You can fill in up to 10 different domain addresses.
  1907.  
  1908. WaterGate uses these names to see if a message is addressed to 
  1909. itself, for example for newsfix or for the listserver.
  1910.  
  1911. If you have a world wide registered UUCPname, you are also allowed 
  1912. to use the .UUCP convention, as in "wsd.UUCP". Don't enter this if 
  1913. you don't have a world wide registered UUCPname!
  1914.  
  1915. The first domain address should be your primary (most important) 
  1916. domain address. WaterGate uses this when it has to write messages. 
  1917. The list server, for example, will always advertise itself as 
  1918. listserver@<your first domain name> and there are loads of other 
  1919. places where this first domain name is used. Make sure this is your 
  1920. most important domain name. The other domain names are just used to 
  1921. WaterGate Manual       Setting up the UUCP system           Page 37
  1922. ---------------------------------------------------------------------
  1923. detect that a message is for this system.
  1924.  
  1925. Examples of domain addresses:
  1926.  
  1927. UUCPname:       rubbish
  1928. Domain names:   rubbish.linknet.nl
  1929.                 rubbish.thehost.linknet.nl
  1930.                 rubbish.UUCP
  1931.  
  1932. In this example, WaterGate accepts mail addressed to 'rubbish', 
  1933. 'rubbish.linknet.nl', 'rubbish.thehost.linknet.nl', and 
  1934. 'rubbish.UUCP' as addressed to itself.
  1935.  
  1936. Smart host
  1937. ----------
  1938.  
  1939. If WaterGate receives a mail message that is not addressed to any 
  1940. node it knows, it will try to send it to your smarthost, UNLESS this 
  1941. mail message already came from there. In that case, the message will 
  1942. be bounced to the original sender, since the smarthost assumed the 
  1943. addressee (which can be a subnode as well as a point) should be 
  1944. known at our site but, since we don't know the addressee, it does 
  1945. not exist.
  1946.  
  1947. Your smarthost is usually the system from which you receive your 
  1948. mailfeed. Even if that system is not capable of smart routing, it 
  1949. should be able to transport the message to a system that is. Enter 
  1950. the UUCP name of your Smarthost in the 'Smarthost' field. Important! 
  1951. Make sure you define a UUCP style node for the system you assign as 
  1952. your smarthost.
  1953.  
  1954. Smarthost: wtrlnd
  1955.  
  1956. Backbone
  1957. --------
  1958.  
  1959. When sending messages in moderated newsgroups, you either know the 
  1960. moderator, or it is sent to a backbone site capable of transporting 
  1961. it to the correct moderator. THIS IS USUALLY NOT YOUR SMARTHOST. If 
  1962. you don't know a backbone site closer to you, leave the setting at 
  1963. its default.
  1964.  
  1965. Backbone: Berkeley.EDU
  1966.  
  1967. Default groups
  1968. --------------
  1969.  
  1970. When new UUCP style users are created, you can connect them to a 
  1971. default combination of area groups. Just select the groups you want 
  1972. using "Def. Groups". See the Fido style default group setup for a 
  1973. complete explanation of how to select and deselect groups.
  1974.  
  1975. Time zone
  1976. ---------
  1977.  
  1978. Messages created by WaterGate contain a time field that is created 
  1979. WaterGate Manual       Setting up the UUCP system           Page 38
  1980. ---------------------------------------------------------------------
  1981. using the system date and time, and the "Time Zone" string added to 
  1982. it.
  1983.  
  1984. Time zone: GMT
  1985.  
  1986. results in:
  1987.  
  1988. Fri, 19 Nov 1993 04:12:50 GMT
  1989.  
  1990. According to the RFC regulations, this field should contain an 
  1991. official TimeZone identifier. Many sites in Europe tend to use 'CET' 
  1992. here, for 'Central European Time', commonly used by European cable 
  1993. and satellite stations such as MTV-Europe. However, this is NOT an 
  1994. official TimeZone!
  1995.  
  1996. Instead, European sites should indicate their relation to Greenwich 
  1997. time by using the timezone identifier, GMT, plus an adjustment. For 
  1998. the European mainland, this is GMT+1 in winters, and GMT+2 in 
  1999. summers (this is a direct result of the phenomenon 'daylight 
  2000. savings').
  2001.  
  2002. Some people like to put phony timezone identifiers here; this may be 
  2003. tremendous fun, but, although it won't bother WaterGate, correct 
  2004. mail handling by your smarthost or other mail systems involved 
  2005. cannot be guaranteed. There are some systems that seem to have a lot 
  2006. of CPU time left and they check to make sure this time zone is a 
  2007. valid string. If it is not, they simply trash the entire message! 
  2008. RFC1036 advises using the GMT time zone.
  2009.  
  2010. Maximum bundle size
  2011. -------------------
  2012.  
  2013. By default, WaterGate will append news messages to the same outgoing 
  2014. mail bundle for each UUCP node during one toss. Mail messages are 
  2015. always put in a separate file.
  2016.  
  2017. If you have downlinks that have trouble with large UUCP *.DAT files 
  2018. you may want to set the ".DAT length" option. WaterGate will then 
  2019. check whether a UUCP message bundle exceeds that limit. If so, it 
  2020. closes it and creates a new one. A setting of "0" disables this 
  2021. option. The default is "200000" (200k) bytes; remember that this is 
  2022. before compression!
  2023.  
  2024. Notice: mail jobs are always in one file. Even large files attached 
  2025. to a mail message are put in one big .DAT file.
  2026.  
  2027. Undeliverable mail
  2028. ------------------
  2029.  
  2030. When a message is sent to your system, but it cannot be delivered 
  2031. because the target system does not exist, then something has to be 
  2032. done with that message. For example, when a message is sent to my 
  2033. system for "somehost.wsd.wline.se",then this message cannot reach it 
  2034. destination because the host "somehost" does not exist as a 
  2035. sub-domain of my system.
  2036.  
  2037. WaterGate Manual       Setting up the UUCP system           Page 39
  2038. ---------------------------------------------------------------------
  2039. In that case, there are two options. First, the message could be 
  2040. sent back to the originator, which can then take appropriate actions.
  2041. Second, it can be written to the netmail area, so the administrator 
  2042. can have a look at it.
  2043.  
  2044. Bounce small
  2045. ------------
  2046.  
  2047. When a undeliverable mail message is sent back, then you want to be 
  2048. able to control how big that message is. For example, it is no use 
  2049. to send an undeliverable UU-encoded mail message of 100kb back to 
  2050. somebody. Instead, only the headers and perhaps the first part of 
  2051. the message should be sent back. This is enough for the originator 
  2052. to find out what was wrong.
  2053.  
  2054. If you don't care about your telephone bill, then set this option to 
  2055. NO, in which case the entire message will be sent back to the 
  2056. originator.
  2057.  
  2058. Mail and news grades
  2059. --------------------
  2060.  
  2061. The first letter in the filenames created in the spool directories 
  2062. (first or second position of the filename, depending on the "munging"
  2063. method) indicates a "grade" to your UUCP mailer (UUCICO). You can 
  2064. tell it to only transfer file up to a certain grade. For example to 
  2065. transfer news in the cheap hours only.
  2066.  
  2067. You can set the grades for mail and news here. You normally don't 
  2068. have to worry about this setting, unless you want to change the 
  2069. grades (= letters in the filenames) used.
  2070.  
  2071. UUCP filenames
  2072. --------------
  2073.  
  2074. During the course of all the testing we found that some 
  2075. implementations didn't like the UUCP job filenames created by 
  2076. WaterGate.
  2077.  
  2078. The problem is difficult the point out, but basically, your provider 
  2079. receives the jobs but then can't process them and your messages 
  2080. never arrive at their destination.
  2081.  
  2082. If this is the case with your UUCICO, then try the "No bitmask" 
  2083. option under WtrConf, System Configuration, UUCP settings.
  2084. WaterGate Manual       Setting up the UUCP system           Page 40
  2085. ---------------------------------------------------------------------
  2086. UUCP compression programs
  2087. -------------------------
  2088.  
  2089. Outgoing UUCP news batches have to be compressed with either the 
  2090. COMPRESS/COMP430D program or GZIP. WaterGate can detect the 
  2091. compression method used for incoming news batches and will 
  2092. automatically spawn the correct decompression program.
  2093.  
  2094. You can enter the details and arguments of these programs in this 
  2095. screen:
  2096.  
  2097. WaterGate Manual       Setting up the UUCP system           Page 41
  2098. ---------------------------------------------------------------------
  2099.     +-----------------------------+
  2100.     | Compress    COMP430D -v     |
  2101.     | De-compress COMP430D -dv    |
  2102.     | GZip        GZIP -v         |
  2103.     | Un-GZip     GZIP -dv        |
  2104.     +-----------------------------+
  2105.  
  2106. For use with "compress" it is wise to define a decompressor here 
  2107. that can handle (and recognize) both 12 and 16 bit compression. 
  2108. WaterGate will usually be able to free up enough memory to perform 
  2109. 16 bit compression and decompression when shelling out to the 
  2110. (de)compressor by swapping itself to XMS/EMS/Disk.
  2111.  
  2112. Make sure you have the correct compression programs. You can find 
  2113. these on the Simtel 20 CD-ROM. On the September 1994 release it was 
  2114. on disc 2 in the directory \DISC2\COMPRESS. BBS's might use the 
  2115. description for this directory, which is "MS-DOS port of UNIX 
  2116. compress, gzip; and compression pgms".
  2117.  
  2118. The names of the files are:
  2119.  
  2120. COMP430D.ZIP
  2121. GZIP124.ZIP
  2122.  
  2123. Don't use PKZIP for GZIP compression or decompression because this 
  2124. will not work!
  2125. WaterGate Manual       Setting up the UUCP system           Page 42
  2126. ---------------------------------------------------------------------
  2127. UUCP newsfix forwarding
  2128. -----------------------
  2129.  
  2130. Newsfix forwarding is exactly like Areafix forwarding, but then for 
  2131. UUCP areas. When a user requests a newsgroup that your system 
  2132. currently doesn't have, you can have WaterGate scan a list of all 
  2133. available newsgroups.
  2134.  
  2135. But, since there is no 'standard' AreaFix alike program for UUCP 
  2136. mail processors, WaterGate is unable to forward a request for such 
  2137. an area. To aid in the development of utilities that can interface 
  2138. with your UUCP host it is capable of creating a text file named 
  2139. UUCPREQ.LST on disk that contains the name of the requested area, 
  2140. and the system it has to be requested from.
  2141.  
  2142. You can define up to fifty (50) listing files and uplink systems. 
  2143. Normally there will only be one UUCP uplink, so you can utilize the 
  2144. other entries to split the listing of newsgroups.
  2145.  
  2146. To configure the newsfix forwarding, select UUCP newsfix forwarding 
  2147. from the System Configuration menu. You will then be presented with 
  2148. a listing with 50 entries. Press Enter to edit one of the entries, 
  2149. you will now see a screen like this:
  2150.  
  2151. WaterGate Manual       Setting up the UUCP system           Page 43
  2152. ---------------------------------------------------------------------
  2153.     +-----------------------------------------------+
  2154.     | UUCP name of uplink     seunet                |
  2155.     | Newsgroups listing path c:\wtrgate\seunet.lst |
  2156.     | Group for created areas A                     |
  2157.     +-----------------------------------------------+
  2158.  
  2159. The UUCP name will be written to the UUCPREQ.LST file and refers to 
  2160. your uplink. Nice there is no automatic processing possible, you 
  2161. could as well fill in another name.
  2162.  
  2163. The newsgroups listing path must be a complete path and filename. 
  2164. The format of the file is a newsgroups list. It starts with the 
  2165. areaname and optionally followed by a description and one or more 
  2166. options (/OPTION).
  2167.  
  2168. The description is put in the Comments field when a new record is 
  2169. created. An example of one line from this file:
  2170.  
  2171. alt.bbs.watergate    WaterGate support
  2172.  
  2173. The group is where the area is initially created. If you have a 
  2174. special group for Usenet areas, then you set this to the letter of 
  2175. that group.
  2176. WaterGate Manual       Gateway Settings                     Page 44
  2177. ---------------------------------------------------------------------
  2178. Gateway Settings
  2179. ----------------
  2180.  
  2181. The gateway is the path messages take when they have to be sent from 
  2182. UUCP to FidoNet or vice versa. The message body is translated to the 
  2183. new format and the headers (from, to, subject, date, etc.) have to be
  2184. translated as well. WaterGate does this all automatically.
  2185.  
  2186. There are a few settings you can tune, almost all of which have to do
  2187. with addressing the gateway and translating addresses. "The Gateway",
  2188. below, will explain how to use the gateway and how to set up 
  2189. mappings, which are address translation helpers.
  2190.  
  2191. You can reach the Gateway Settings screen via the System Settings 
  2192. menu. That screen looks like this: WaterGate Manual       Gateway Settings                     Page 45
  2193. ---------------------------------------------------------------------
  2194.  
  2195.  
  2196.     +--------------------------------------------------+
  2197.     |                        --- Fido to UUCP ---      |
  2198.     | Gateway                2:280/802@joho            |
  2199.     | Gateway User           UUCP                      |
  2200.     | Gateway TO             no YES                    |
  2201.     | Kill gated netmail     NO yes                    |
  2202.     | Allow headers          no YES                    |
  2203.     | Line wrap              72                        |
  2204.     |                                                  |
  2205.     |                        --- UUCP to Fido ---      |
  2206.     | FSC-35 kludges?        no YES                    |
  2207.     | Fido From:             e-mail address FULL NAME  |
  2208.     | Copy headers           <press enter to edit>     |
  2209.     | ASCII Conversion       <press enter to edit>     |
  2210.     | Message-ID to MSGID    NO include                |
  2211.     | Organization to Origin no yes OVERRIDE           |
  2212.     |                                                  |
  2213.     |                        --- Both directions ---   |
  2214.     | Name separator         _                         |
  2215.     | Small addresses        no YES                    |
  2216.     +--------------------------------------------------+
  2217.  
  2218. The screen is split up in three parts, related to the direction of 
  2219. the gateway on which the option has effect.
  2220.  
  2221. Gateway AKA
  2222. -----------
  2223.  
  2224. This is not the node number on which the gateway can be reached from 
  2225. within FidoNet. In fact, you and your users can reach the gateway on 
  2226. any of your system node numbers.
  2227.  
  2228. The gateway AKA is used to calculate what parts of an FidoNet 
  2229. address need to be put in the domain part of the resulting Internet 
  2230. address. It is also used to restore this complete node number on the 
  2231. way back.
  2232.  
  2233. For example:
  2234.  
  2235. Gateway             = 2:280/802
  2236. Sender              = "xx" at 2:280/802
  2237. First system domain = wsd.wline.se
  2238. -> Result           = xx@p15.wsd.wline.se
  2239.  
  2240. On the way back:
  2241.  
  2242. Incoming            = xx@p15.wsd.wline.se
  2243. Gateway             = 2:280/802
  2244. -> Result           = "xx" at 2:280/802.15
  2245.  
  2246. Notice that this information is not used when mapping statements are 
  2247. in effect (MAP-UUCP).
  2248.  
  2249. It is perfectly valid to use a point address for the gateway node 
  2250. WaterGate Manual       Gateway Settings                     Page 46
  2251. ---------------------------------------------------------------------
  2252. number.
  2253.  
  2254. Gateway User
  2255. ------------
  2256.  
  2257. In order for WaterGate to know that a message must go through the 
  2258. gateway, you have to tell it what username will appear in the To: 
  2259. field of netmail messages destined for the gateway. The default is 
  2260. UUCP, a common choice, but it can be changed to anything.
  2261.  
  2262. You have to put the recipient address (of the person which is to 
  2263. receive your e-mail) on the first line of the body of the message, 
  2264. preceded by "To:" (case insensitive).
  2265.  
  2266. Gateway TO
  2267. ----------
  2268.  
  2269. If the option "Gateway TO" is set to YES, WaterGate also scans the 
  2270. To: field of the netmail for a UUCP address. In that case, you don't 
  2271. have to put the UUCP address on the first line of the body of the 
  2272. message, but you can then simply put it in the To: field of the 
  2273. FidoNet message, provided the entire address fits in the To: field.
  2274.  
  2275. Kill gated netmail
  2276. ------------------
  2277.  
  2278. If you write a message in the netmail area that has to be sent to 
  2279. UUCP, you may want it to remain there after it has been sent so you 
  2280. can move it to another area (history, for example). If you don't 
  2281. want it to stay in the netmail area after gating it, you can put the 
  2282. Kill/Sent flag on it with your editor.
  2283.  
  2284. If one of your points or downlinks sends a netmail to the gateway 
  2285. and he or she does not put a Kill/Sent flag on the message, this 
  2286. message will remain in your netmail area after it has been gated. 
  2287. After a while, these messages pile up.
  2288.  
  2289. If you set this toggle to YES, all netmails that were gated to UUCP 
  2290. are automatically given a Kill/Sent flag, so WaterGate deletes them 
  2291. after gating. This keeps your netmail area free of already gated 
  2292. messages.
  2293.  
  2294. FSC-35 kludges
  2295. --------------
  2296.  
  2297. If a message is translated from UUCP to FidoNet, you have to be able 
  2298. to reply to it from within your editor. This can be done in several 
  2299. ways. The newer editors support FSC-35, which makes replying to a 
  2300. message from UUCP very simple. Two kludges are added to the message: 
  2301. REPLYTO and REPLYADDR. The first contains the AKA and username of 
  2302. the gateway and the second holds the Internet address of the sender 
  2303. of the message (that's where the reply has to go).
  2304.  
  2305. If there are more than one possible reply address, then WaterGate 
  2306. creates one or more REPLYALSO kludges as well, but there are no 
  2307. editors at this moment to support these kludges and present you with 
  2308. WaterGate Manual       Gateway Settings                     Page 47
  2309. ---------------------------------------------------------------------
  2310. a list of return addresses to select from.
  2311.  
  2312. Fido From:
  2313. ----------
  2314.  
  2315. If your editor does not support FSC-35, you have to reply to the 
  2316. message by manually putting the UUCP address on the first line of 
  2317. the message. But since WaterGate is also capable of finding the 
  2318. recipient's address in the Fido To: field, it would be handy if it 
  2319. was in the From: field of the message you are going to reply to. 
  2320. Your editor will then automatically setup a message from you to 
  2321. whatever was in the From: field. If this is the complete Internet 
  2322. address, you are done and don't need to type anything more. Set this 
  2323. option to "e-mail address" if you want this.
  2324.  
  2325. If the e-mail address does not fit in the To: field of the message, 
  2326. WaterGate automatically puts the address of the sender in the body 
  2327. of the message, preceded by "Message Sender:".
  2328.  
  2329. If your editor does support FSC-35, you don't need the UUCP address 
  2330. in the From: field of the message. Some addresses are very ugly to 
  2331. look at and it would be much nicer if the full name of the sender of 
  2332. the message was in this field, as with normal FidoNet messages. If 
  2333. you set the option "Fido From:" to "full name", WaterGate puts the 
  2334. full name of the sender of the UUCP message in the From: field.
  2335.  
  2336. If you want the full name of the sender in the From: field and the 
  2337. address in the body of the message, you have to use Copy Headers.
  2338.  
  2339. Copy Headers
  2340. ------------
  2341.  
  2342. A UUCP messages contains several "header" lines. If a message is 
  2343. gated to a FidoNet message, these headers are lost, unless you use 
  2344. this option. You have to put the cursor on this field in the "Gateway
  2345. Settings" screen and then press Enter to change the settings. You 
  2346. will then see the following screen: WaterGate Manual       Gateway Settings                     Page 48
  2347. ---------------------------------------------------------------------
  2348.  
  2349.  
  2350.     +-(30)--------------------------------------------+
  2351.     | E-mail/news headers to copy to netmail/echomail |
  2352.     +-------------------------------------------------+
  2353.     | From:                  Copy as kludge           |
  2354.     | To:                    Copy as kludge           |
  2355.     | Subject:               Copy as kludge           |
  2356.     | Date:                  Copy as kludge           |
  2357.     | Message-Id:            Don't copy               |
  2358.     | Organization:          Copy as plain text       |
  2359.     | From                   Don't copy               |
  2360.     | Path:                  Don't copy               |
  2361.     | Newsgroups:            Don't copy               |
  2362.     |                        Don't copy               |
  2363.     |                        Don't copy               |
  2364.     +-------------------------------------------------+
  2365.  
  2366. The left column holds the header name to search for (case 
  2367. insensitive) and the right column tells what to do with it. You can 
  2368. have to copied to the netmail or echomail as a kludge line or as 
  2369. plain text, or don't copy at all.
  2370.  
  2371. Of the 30 entries you can make, a set of common header lines have 
  2372. already been set up. You can change them, delete them and add some 
  2373. more.
  2374.  
  2375. WaterGate searches for the header line with a space appended to it. 
  2376. This is important, because "From" and "From:" are different headers 
  2377. and we don't necessarily want to match both. Also, don't forget the 
  2378. terminating colon (':') after the header name!
  2379.  
  2380. Note: There is a known problem with Remote Access together with 
  2381. BlueWave. When you download messages with BlueWave, you can get a 
  2382. number of empty lines before the actually message body starts. This 
  2383. has to do with too long headers that were copied as kludges. It is 
  2384. assumed that the bug lies within Remote Access. If you experience 
  2385. this problem, then check on the headers you copy as kludges.
  2386.  
  2387. ASCII conversion
  2388. ----------------
  2389.  
  2390. High ASCII characters (values >128) are widely used within FidoNet, 
  2391. but are illegal in plain text messages on the Internet. WaterGate 
  2392. will replace those characters when converting a message into UUCP 
  2393. format using a conversion table.
  2394.  
  2395. You can specify an appropriate "low ASCII" value for each "high 
  2396. ASCII" value. For example, characters with an umlaut can be replaced 
  2397. with their equivalent without the umlaut.
  2398.  
  2399. To support computers that are using a different high ASCII table than
  2400. the Latin one used in most American and European computers, you can 
  2401. use the 'ASCII conversion' option to re-define the default table. If 
  2402. you mess up the table really bad, then you can press F5 to restore 
  2403. the default table.
  2404. WaterGate Manual       Gateway Settings                     Page 49
  2405. ---------------------------------------------------------------------
  2406. WaterGate cannot convert one-letter characters to two letters. Future
  2407. version will support different character sets (supporting the CHRS 
  2408. kludge) and multi-character translation.
  2409.  
  2410. Message-ID to MSGID conversion
  2411. ------------------------------
  2412.  
  2413. This option allows transparant gating of Message-ID headers into 
  2414. FidoNet and back again. The contents of the Message-ID header will 
  2415. be put in the MSGID kludge of the Fido message and recovered when a 
  2416. reply is sent.
  2417.  
  2418. Some tossers cannot handle this irregular, but completely legal 
  2419. format and might even crash. Use NO if you experience problems or 
  2420. use INCLUDE if you want to be a completely transparent gateway.
  2421.  
  2422. Notice that WaterGate always puts the MSGID and REPLY kludges in a 
  2423. Message-ID: or In-Reply-To: header (FidoNet to Internet/Usenet). You 
  2424. only control the other direction with this toggle.
  2425.  
  2426. Organization to Origin conversion
  2427. ---------------------------------
  2428.  
  2429. With this option you can tell WaterGate to gate the Organization: 
  2430. header from a news message into the Origin line of the resulting 
  2431. echomail.
  2432.  
  2433. Since you can also use Copy Headers to copy the Organization: line 
  2434. into the body of a gated message, you can override that option for 
  2435. echomail here.
  2436.  
  2437. Set this toggle to NO to disable the function. Set it to YES to 
  2438. always put the Organization: header in the Origin line and use 
  2439. OVERRIDE to disable the Copy Headers entry for the Organization: 
  2440. header when using this option.
  2441.  
  2442. You can edit language entry 105 to configure how the Organization: 
  2443. header is gated into the Origin.
  2444.  
  2445. Name separator
  2446. --------------
  2447.  
  2448. The name separator is used to convert Fido names to names compatible 
  2449. with UUCP systems. It replaces all spaces in the Fido user name with 
  2450. the character you configure here.
  2451.  
  2452. Examples (replacement character is underscore '_'):
  2453.  
  2454.         "Jaap Aap"
  2455.   ->    Jaap_Aap@...
  2456.  
  2457.         "Ramon van der Winkel"
  2458.   ->    Ramon_van_der_Winkel@...
  2459.  
  2460.         "Michel van.der.Laan"
  2461.   ->    Michel_van.der.Laan@...
  2462. WaterGate Manual       Gateway Settings                     Page 50
  2463. ---------------------------------------------------------------------
  2464. The default is to use the underscore ('_'), because some BBS users 
  2465. still use dots ('.') to separate the parts of their names, as in the 
  2466. last example. The problem with those names is not the translation 
  2467. _to_ UUCP, but _from_ UUCP. If the last example was translated with 
  2468. a dot, it would be "Michel.van.der.Laan". If that is translated back,
  2469. you get "Michel van der Laan", instead of "Michel van.der.Laan".
  2470.  
  2471. Small addresses
  2472. ---------------
  2473.  
  2474. The small addresses option is used to keep the result of translating 
  2475. a Fido addresses into a UUCP address as small as possible. If 
  2476. WaterGate has to put the sender's FidoNet address in a UUCP address, 
  2477. it creates an address with this format:
  2478.  
  2479. p<point>.f<node>.n<net>.z<zone>.<first system domain address>
  2480.  
  2481. For example: 2:280/802.33 -> p33.f802.n280.z2.wlink.nl
  2482.  
  2483. But a lot of this information is actually unnecessary if your gateway
  2484. AKA closely matches this address, for example 2:280/802.
  2485.  
  2486. If "Small Addresses" is set to YES, WaterGate removes all the parts 
  2487. of the Fido address that match, so the result would then be:
  2488.  
  2489. p33.wlink.nl
  2490.  
  2491. Your system's points are just
  2492.  
  2493. user@p<pointnr>.wlink.nl
  2494.  
  2495. and that is a lot better-looking than the complete, big address.
  2496.  
  2497. When a message is received from UUCP in the form above, the Gateway 
  2498. AKA is again used to reconstruct the full FidoNet recipient's 
  2499. address.
  2500.  
  2501. Note that if your gateway AKA contains a point number, this point 
  2502. number is ignored when constructing the complete address. Otherwise 
  2503. the point number would always be in the recipient's address (also if 
  2504. that is a node), if it was not in the UUCP address. So, you can 
  2505. safely use a point number for your gateway.
  2506. WaterGate Manual       More installation options            Page 51
  2507. ---------------------------------------------------------------------
  2508. Private mail settings
  2509. ---------------------
  2510.  
  2511. Scanning through your mail areas, wondering if anybody wrote you a 
  2512. message to you can become quite a tedious job if you subscribe to 
  2513. lots of areas. And then there all the areas that pass through your 
  2514. system but aren't imported, so you'll never know if somebody isn't 
  2515. desperately trying to give you that "change of a lifetime <tm>" 
  2516. (Starting to feel a little paranoid?)
  2517.  
  2518. Well fear no more! Simply select "Private mail options" from the 
  2519. System Configuration menu. Choose what kind of message base you want 
  2520. to use to store those private messages, or select NONE to disable 
  2521. all private mail copying. Make sure you enter a correct path for the 
  2522. base! You need to enter a directory name for *.MSG or a complete path
  2523. plus filename (without extension!) for JAM and Squish.
  2524.  
  2525. WaterGate is capable of scanning for messages TO or FROM a certain 
  2526. user, or with a certain SUBJECT. Comparisons are case-insensitive, 
  2527. so 'Spock', 'SPOCK' and 'SpOcK' should all work OK.
  2528.  
  2529. The search strings you enter don't have to match what you're 
  2530. searching for completely. For example, "Ramon" will find all 
  2531. messages, either to my e-mail address ramon@wsd.wline.se, or my 
  2532. munged address Ramon.van.der.Winkel@p33.wline.se, or even when 
  2533. somebody uses my name (even misspelled) in a subject, like "What I 
  2534. think about Ramona". If the search string you enter can be found in 
  2535. the searched lines, then you have a match.
  2536.  
  2537. The matching messages are completely copied into the message base, 
  2538. preceded by a short notice that the message was copied.
  2539.  
  2540. The private mail scan searches incoming netmail, echomail, mail, and 
  2541. news. Messages that are leaving your message bases are not scanned, 
  2542. although certain constructions might cause a hit on those messages 
  2543. as well.
  2544.  
  2545. It is also possible to decode files from messages written to the 
  2546. message base connected to this private scan area. This is currently 
  2547. limited to *.MSG only though.
  2548.  
  2549. An interesting use for the private mail scan option is to copy all 
  2550. messages to you and enable decoding of enclosed files.
  2551.  
  2552. This way, you primary netmail area is not scanned and files are not 
  2553. decoded for users that are not even on your system.
  2554.  
  2555. Set the option "Decode files" to YES and enter a path to the 
  2556. directory where to store the decoded files.
  2557.  
  2558. WaterGate can decode uu-encoded, xx-encoded and MIME base64 encoded 
  2559. messages.
  2560. WaterGate Manual       More installation options            Page 52
  2561. ---------------------------------------------------------------------
  2562. Log file settings
  2563. -----------------
  2564.  
  2565. WaterGate is capable of logging a lot of things. Not only error 
  2566. messages, but also progress of tossing for both FidoNet and UUCP. 
  2567. These progress log lines can take up an awful lot of log file and 
  2568. you might not even be interested in them at all.
  2569.  
  2570. If you select "Logfile settings" from the "System Configuration" 
  2571. sub-menu of WtrConf, then you can toggle various logging information 
  2572. generators on and off.
  2573.  
  2574. If you want to debug your WaterGate configuration, you can choose to 
  2575. set the Debug option to YES, which will automatically enable all 
  2576. other options you can set.
  2577.  
  2578. Currently, you can disable a number of 16 or so of the log file 
  2579. information generators, but more option are added every now and then.
  2580. WaterGate Manual       More installation options            Page 53
  2581. ---------------------------------------------------------------------
  2582. Administrator
  2583. -------------
  2584.  
  2585. The administrator user maintains the WaterGate program and the flow 
  2586. of messages. In case of trouble, the administrator should solve 
  2587. things.
  2588.  
  2589. To support a "remote" administrator, the administrator address was 
  2590. built in. You can either have a UUCP style administrator or FidoNet 
  2591. style administrator, which require different addresses.
  2592.  
  2593. Following is the configuration screen for the Administrator Settings:
  2594.  
  2595.     +-----------------------------------------------------+
  2596.     | Administrator Settings                              |
  2597.     |                                                     |
  2598.     | Address type   disable FIDO uucp                    |
  2599.     |                                                     |
  2600.     | Fido username  WaterGate Administrator              |
  2601.     | Fido address   1:2/3.4                              |
  2602.     |                                                     |
  2603.     | E-mail address                                      |
  2604.     |                                                     |
  2605.     | Send log?      no YES                               |
  2606.     |                                                     |
  2607.     |                (more to come in future releases)    |
  2608.     +-----------------------------------------------------+
  2609.  
  2610. At this moment, you can only use the administrator to send it a copy 
  2611. of the part of the log file that was last added by the wtrgate.exe 
  2612. program.
  2613.  
  2614. In future, it will be possible to use the administrator to help 
  2615. WaterGate in its decisions on where to send mail messages, and 
  2616. possible to edit the configuration.
  2617. WaterGate Manual       Groups                               Page 54
  2618. ---------------------------------------------------------------------
  2619. Groups
  2620. ------
  2621.  
  2622. Before discussing message area setup, it is important to know about 
  2623. groups.
  2624.  
  2625. If you have a lot of areas, there might be a few that you don't want 
  2626. all the users to read, for example the SysOp areas. Because users can
  2627. connect and disconnect areas themselves, using AreaFix or newsfix, 
  2628. there has to be a way to differentiate these areas from each other.
  2629.  
  2630. If you are in more than one network, it is also important to keep the
  2631. areas of the different networks separated. Every network has its own 
  2632. AKAs that have to be used in messages written in those networks. If 
  2633. you connect some of these areas to UUCP, the correct AKA has to be 
  2634. used when a message is gated from UUCP.
  2635.  
  2636. WaterGate uses "groups" to keep the areas separated. The groups are 
  2637. named A through Z, where Z is a special group for automatically 
  2638. created new areas. You can enter a description for each of the 
  2639. groups, so it is easy to tell them apart, and you can select a 
  2640. "Default origin AKA" for every group.
  2641.  
  2642. You can then select which areas belong in which groups. It is also 
  2643. possible for an area to be in more than one group at a time.
  2644.  
  2645. You can give your users access to some of the groups. They can then 
  2646. use AreaFix or newsfix to connect areas that are in those groups and 
  2647. nothing else.
  2648.  
  2649. It is also possible to make a group read-only. This means that users 
  2650. can connect to an area in that group and receive messages from it, 
  2651. but cannot write a message back. If you only want this for some of 
  2652. your users, you can put these areas in two groups: one read-only and 
  2653. one read/write. If you put an area in a read-only group, you have to 
  2654. put it in a read/write area as well or your uplink will not be able 
  2655. to deliver any messages to this area.
  2656.  
  2657. You can edit the group descriptions, default origin AKA, and 
  2658. read-only flag via the "Group descriptions" option in WtrConf's main 
  2659. menu.
  2660. WaterGate Manual       Area Definitions                     Page 55
  2661. ---------------------------------------------------------------------
  2662. Area Definitions
  2663. ----------------
  2664.  
  2665. This section explains in detail how to create an area. An area can be
  2666. either a FidoNet echomail area or a Usenet newsgroup. It is possible 
  2667. for both FidoNet style users and UUCP style users to be subscribed 
  2668. (as we call it) to the same area. If a message has to be sent to both
  2669. UUCP and FidoNet style users, WaterGate automatically translates the 
  2670. message.
  2671.  
  2672. So, if you want to give your points access to newsgroups, then just 
  2673. create the areas and subscribe the points to them. It works the same 
  2674. the other way around: if you want a UUCP system to receive FidoNet 
  2675. echomail, then just create the area and connect the UUCP user.
  2676.  
  2677. This has two advantages. First, you only have to define an area once 
  2678. and, second, WaterGate can bundle the message very quickly. If it is 
  2679. an echomail message, WaterGate first bundles it for all subscribed 
  2680. FidoNet users, then translates it (if there are any connected UUCP 
  2681. users), and finally bundles it for all the UUCP users. (In fact, 
  2682. WaterGate can even be extended to use another formats in the future 
  2683. and was designed with that in mind).
  2684.  
  2685. To create a new area, select "Area definitions" from WtrConf's main 
  2686. menu. You will then be presented with a list of all 26 groups (A to 
  2687. Z). Select one group (or more, using tagging with F5, F6 and F7) that
  2688. you want to see all the areas from. Then press enter.
  2689.  
  2690. If you have a lot of areas (1000+), it might take a while before the 
  2691. list with all the areas names has been constructed. It is possible 
  2692. to abort the construction of the list of areas by pressing Escape. 
  2693. But in the end, you will have a sorted list with all the areas and 
  2694. the header line of the lists will show the groups you selected.
  2695.  
  2696. You can now press Insert to add a new area, or press the Delete key 
  2697. to remove one. If you want to look at one or edit it, put the cursor 
  2698. on top of the area name and press Enter. If you want to go back to 
  2699. the previous menu, just press Escape.
  2700.  
  2701. After pressing Enter or Insert, you are presented with the screen on 
  2702. the following page. It contains all the settings you can change for 
  2703. a certain area. You can use the up and down cursor keys to move 
  2704. through all the fields. If you want to change a field, you have to 
  2705. press Enter first.
  2706.  
  2707. If you want to exit the screen, you can press Escape or F10 (escape 
  2708. is more like abort, but they act the same). If you are creating a 
  2709. new area, you are asked if you want to save the new area. If you 
  2710. select Yes, certain fields have to be filled in correctly and WtrConf
  2711. checks that for you.
  2712.  
  2713. Some of the fields contain the text "<press enter to ...>". If the 
  2714. cursor is on one of these fields and you press enter to edit it, you 
  2715. will be presented another screen. The same thing happens when you 
  2716. edit the "In groups" field.
  2717.  
  2718. WaterGate Manual       Area Definitions                     Page 56
  2719. ---------------------------------------------------------------------
  2720.     +---------------------------------------------+
  2721.     | Fido name     ALT.BBS.WATERGATE             |
  2722.     | Usenet name   ALT.BBS.WATERGATE             |
  2723.     | Comment       WaterGate support area        |
  2724.     | Area type     ECHO net local                |
  2725.     | In groups     A                             |
  2726.     | Subscribers   <press enter to see list>     |
  2727.     | Allow Passive no YES                        |
  2728.     | Passive       NO yes                        |
  2729.     | Origin        BOFH is watching you!         |
  2730.     | Custom                                      |
  2731.     | Origin AKA    2:280/802                     |
  2732.     | Add SEEN-BY   <press enter to see list>     |
  2733.     | Moderated     NONE use                      |
  2734.     | Moderator                                   |
  2735.     | Fido base     none msg squish JAM           |
  2736.     | Fido path     W:\MSGS\ABWG                  |
  2737.     | Fido age      5                             |
  2738.     | Fido limit    200                           |
  2739.     | Decode files  no ON IMPORT                  |
  2740.     | Files path    D:\DECODED\ABWG\              |
  2741.     +---------------------------------------------+
  2742.  
  2743. Area name
  2744. ---------
  2745.  
  2746. The first two lines of the screen hold the area names for FidoNet 
  2747. and Usenet. Normally these names will be the same, but is possible 
  2748. to change the name of an area. We could change the Fido name to 
  2749. "WTRGATE.028", for example.
  2750.  
  2751. If you enter a name in the "Fido name" field, and there is no name 
  2752. in the "Usenet name" field, it is automatically copied. The same 
  2753. thing happens if you enter an area name in the Usenet name field and 
  2754. the Fido name field is empty. This saves you some typing and 
  2755. prevents errors.
  2756.  
  2757. Comment
  2758. -------
  2759.  
  2760. You can use the Comment field to describe the message flow in this 
  2761. area. This line is put in lists that AreaFix or newsfix create, to 
  2762. make it is easy for your users to see which area might be interesting
  2763. to connect.
  2764.  
  2765. Area type
  2766. ---------
  2767.  
  2768. There are three types of areas: echo, net, and local. "Local" is an 
  2769. area that is connected to a message base on your hard disk (more on 
  2770. that later), "net" stands for netmail. This way you can define 
  2771. other-than-the-primary netmail areas. The usual setting though is 
  2772. "echo", which stands for Echomail. Echo is also the option if you 
  2773. want to say "pass-through", although all areas are pass-through 
  2774. until you connect them to a message base (explained below).
  2775.  
  2776. WaterGate Manual       Area Definitions                     Page 57
  2777. ---------------------------------------------------------------------
  2778. In groups
  2779. ---------
  2780.  
  2781. This field shows all the groups to which this area belongs. If you 
  2782. press Enter to edit this field, the line turns into a list with not 
  2783. only the group letter, but also the full description.
  2784.  
  2785. To add another group, press Insert and select (with Enter) a group 
  2786. from the other list that pops up. To remove the area from a group, 
  2787. select the group and press the Delete key. You can also use tagging 
  2788. to add or remove more than one group at a time.
  2789.  
  2790. Subscribers
  2791. -----------
  2792.  
  2793. If you press enter on this field, you will be presented with a list 
  2794. of the users connected to the area. You can use the Insert key to 
  2795. add a user or the Delete key to remove a user; you can also tag lists
  2796. of users to add or remove. If you try to remove a user, WtrConf asks 
  2797. you to confirm your choice.
  2798.  
  2799. If you want to add a user, WtrConf scans the configured users and 
  2800. only lists the users that are allowed to connect the area. These 
  2801. users must be allowed in a group that contains this area.
  2802.  
  2803. If you are finished editing the list of subscribed users, you can 
  2804. press Escape to exit the list and return to the area screen.
  2805.  
  2806. Allow passive
  2807. -------------
  2808.  
  2809. If nobody is subscribed to an area anymore, you can let WaterGate 
  2810. send a message to the provider (uplink) of the area and have it 
  2811. disconnected, thereby saving you transmission costs for an area that 
  2812. nobody reads.
  2813.  
  2814. If this options is set to NO, WaterGate will never disconnect the 
  2815. area. This is especially useful for local message bases.
  2816.  
  2817. WaterGate assumes that the last person connected to the area (when 
  2818. everybody else has disconnected it) is the provider.
  2819.  
  2820. Passive
  2821. -------
  2822.  
  2823. This field shows the current state of the area. If it has been 
  2824. disconnected from your uplink, WaterGate sets it to YES. If it is 
  2825. still connected, it is on NO. You can toggle this setting manually, 
  2826. but no message will be sent to your uplink. (Future versions will do 
  2827. this, after asking for confirmation.)
  2828.  
  2829. Origin
  2830. ------
  2831.  
  2832. You can select which system origin line will be used for this area. 
  2833. You can also select Custom and enter a special origin line for this 
  2834. WaterGate Manual       Area Definitions                     Page 58
  2835. ---------------------------------------------------------------------
  2836. area in the next field.
  2837.  
  2838. The origin line is put at the bottom of a message when WaterGate 
  2839. translates a message from UUCP to FidoNet, or when it exports a 
  2840. message from a message base and no origin line is present.
  2841.  
  2842. Custom
  2843. ------
  2844.  
  2845. You can enter a custom origin line for this area in this field. To 
  2846. activate it, you also have to set the previous field to "Custom".
  2847.  
  2848. Origin AKA
  2849. ----------
  2850.  
  2851. Every area belongs to a certain network. Here you can select your 
  2852. system AKA for the network this area belongs to. When you create a 
  2853. new area, the AKA is copied from the "Default origin AKA" of the 
  2854. first group that includes this area. This AKA is also put at the end 
  2855. of an origin line.
  2856.  
  2857. Add SEEN-BY
  2858. -----------
  2859.  
  2860. If your system has more than one AKA in a network and you want other 
  2861. AKA's to be added to the SEEN-BY list, you can select them in this 
  2862. list. You have to press Enter first to see the list. The Origin AKA 
  2863. for this area is always added to the SEEN-BY line and doesn't need 
  2864. to be put in this list.
  2865.  
  2866. Moderated and Moderator
  2867. -----------------------
  2868.  
  2869. These two fields relate to Usenet. If an area is moderated, then all 
  2870. new messages for an area have to be sent to the moderator first. If 
  2871. the moderator approves the message, it is then sent to the newsgroup.
  2872.  
  2873. If a new message arrives in a moderated area without an "Approved:" 
  2874. header, WaterGate converts the message into a UUCP e-mail and sends 
  2875. it to the moderator. If no moderator is defined for the newsgroup, 
  2876. it is sent to the backbone defined in the System configuration 
  2877. section, which defaults to "berkeley.edu". For example, a message in 
  2878. ALT.BBS.XYZ is sent to ALT-BBS-XYZ@Berkeley.edu.
  2879.  
  2880. If you are unsure about any of this, DON'T USE THIS OPTION; let 
  2881. another system upstream take care of it. If someone you know 
  2882. moderates the area, enter his address in the "Moderator" field.
  2883.  
  2884. Fido base and path
  2885. ------------------
  2886.  
  2887. If you want all messages in the area to be put in a message base as 
  2888. well as being passed on to subscribers, you can select the type of 
  2889. the message base in the "Fido base" field and fill in the path to 
  2890. the message base in "Fido path". You can select a message base type 
  2891. from *.MSG, Squish, and JAM. For a *.MSG area you need to fill in 
  2892. WaterGate Manual       Area Definitions                     Page 59
  2893. ---------------------------------------------------------------------
  2894. the complete directory name; for Squish and JAM you also need to 
  2895. include a filename (without extension).
  2896.  
  2897. Fido age and limit
  2898. ------------------
  2899.  
  2900. You can use WtrUtil to automatically clean the message bases. If 
  2901. certain messages are too old or there are too many messages in an 
  2902. area, they can be removed automatically.
  2903.  
  2904. You can enter the maximum age of a message (in days) in the "Fido 
  2905. age" field and the maximum number of messages that can be in an area 
  2906. at any one time in "Fido limit".
  2907.  
  2908. Note that when there are too many message in an area, the oldest 
  2909. messages are deleted first. The deletion is not automatic: you have 
  2910. to use WtrUtil to remove them.
  2911.  
  2912. If you don't want to remove messages by age or limit, you can see 
  2913. the field to 0.
  2914.  
  2915. Decode files
  2916. ------------
  2917.  
  2918. WaterGate can automatically detect and decode UU-encoded, XX-encoded 
  2919. and MIME encoded files from messages. It extract the file and saves 
  2920. it to disk.
  2921.  
  2922. It does this when the messages is imported into a message base. This 
  2923. prevents the messages from being split in numerous smaller parts 
  2924. which you otherwise had to put together and decode manually.
  2925.  
  2926. Using this option you can enable and disable the automatic decoding 
  2927. of files from messages that are imported into this message base.
  2928.  
  2929. Notice that WaterGate currently only support extracting files from 
  2930. messages that are imported into a *.MSG base. JAM and Squish support 
  2931. will follow in a future version.
  2932.  
  2933. Files path
  2934. ----------
  2935.  
  2936. The automatically decoded files can be stored in a different 
  2937. location (download area?!) for each message base. You can enter the 
  2938. path to that directory in this field.
  2939. WaterGate Manual       User Definitions                     Page 60
  2940. ---------------------------------------------------------------------
  2941. User Definitions
  2942. ----------------
  2943.  
  2944. A user in the WaterGate system represents a system with which you 
  2945. exchange messages. There are three different types of users, 
  2946. depending on the method you use the exchange messages with that user:
  2947.  
  2948.    - FidoNet
  2949.    - UUCP
  2950.    - Bag supplier
  2951.    - SMTP interface
  2952.  
  2953. A FidoNet style user basically uses .PKT files, a UUCP user uses the 
  2954. UUCP mechanism, a Bag supplier only sends messages to you in .BAG 
  2955. files and SMTP interface uses two directories for message to and from
  2956. the application that does the actually SMTP transport.
  2957.  
  2958. You can add or remove users using the "User definitions" option from 
  2959. the main menu. After pressing the Enter key to select the option 
  2960. from the main menu, you will be presented with a list of all the 
  2961. currently defined users. Depending on their type, their UUCP name or 
  2962. Fido address will also be shown.
  2963.  
  2964. You can add a user by pressing the Insert key, or delete a user by 
  2965. pressing the Delete key. Pressing Escape returns you to the main 
  2966. menu.
  2967.  
  2968. When adding a user to your system, you are asked what type of user 
  2969. record you want to add. After having selected the type of user, you 
  2970. will be presented with a screen where you can enter all the user's 
  2971. settings. Since these screens differ quite a bit from each other, 
  2972. they will be described separately.
  2973.  
  2974. FidoNet style user
  2975. ------------------
  2976.  
  2977. As stated before, a FidoNet style user exchanges mail with you via 
  2978. .PKT files. These files may also be archived and compressed.
  2979.  
  2980. Besides the normal FidoNet settings you might be used to, WaterGate 
  2981. also offers the capability to let the FidoNet style user 
  2982. transparently integrate with Usenet / Internet. That is, to receive 
  2983. and send e-mail and read and write news. If you want this user to be 
  2984. able to do that, you also have to fill in some or all of the fields 
  2985. that relate to UUCP.
  2986.  
  2987. The screen to edit the settings for a FidoNet style user looks close 
  2988. to the screen below. Notice that WtrConf uses different screen 
  2989. layouts, depending on the number of lines your screen can handle.
  2990.  
  2991. WaterGate Manual       User Definitions                     Page 61
  2992. ---------------------------------------------------------------------
  2993.     +-[Fido style user]-------------------------------------+
  2994.     | Address           2:200/112.15                        |
  2995.     | SysOp             Ramon van der Winkel                |
  2996.     | Organization      Waterline Software Development      |
  2997.     | Allowed groups    ABC           OP                    |
  2998.     | Subscribed to     <press enter to see list>           |
  2999.     | AreaFix password  verysecret                          |
  3000.     | AreaFix special   NO yes                              |
  3001.     | Create new areas  NO yes                              |
  3002.     | Passive           NO yes                              |
  3003.     | PKT password      wsdpkt                              |
  3004.     | Compression       arc arj lzh pak ZIP zoo rar op1 pkt |
  3005.     | Send format       NORMAL hold crash direct            |
  3006.     | Export AKA        Automatic                           |
  3007.     | Decode files      NO yes                              |
  3008.     | Max. PKT length   0                                   |
  3009.     | UUCP name         wsd                                 |
  3010.     | World registered  NO yes                              |
  3011.     | Allow sub-domains no YES                              |
  3012.     | Domain addresses  wsd.wline.se                        |
  3013.     |                   admin.wline.se                      |
  3014.     |                                                       |
  3015.     |                                                       |
  3016.     |                                                       |
  3017.     |                                                       |
  3018.     +-------------------------------------------------------+
  3019.  
  3020. Organization
  3021. ------------
  3022.  
  3023. The Organization field is common to all users. It is used when a 
  3024. UUCP message is created for the user--in this case, when a FidoNet 
  3025. message is translated into a UUCP message. The "Organization" header 
  3026. in that UUCP message will be filled in with whatever you type here.
  3027.  
  3028. If you leave this line blank, no "Organization:" header will be put 
  3029. in the UUCP message.
  3030.  
  3031. Allowed groups
  3032. --------------
  3033.  
  3034. This field shows you which groups this user is allowed in. Each group
  3035. can contain a number of areas, so the groups filter effectively 
  3036. grants the user access to those areas. This is used by AreaFix and 
  3037. WtrConf.
  3038.  
  3039. If you want to connect this user to an area, WtrConf only shows you 
  3040. the areas that this user is allowed in. It is perfectly possible, 
  3041. though, to connect a user to an area that is not in one of these 
  3042. groups, by adding the group letter, connecting the area and removing 
  3043. the group letter again. (Future versions of WtrConf will warn you 
  3044. when a user is connected to an area without being allowed in a group 
  3045. that includes it.)
  3046.  
  3047. To edit the groups filter, press Enter on the field. You will now be 
  3048. presented with a list of groups this user is allowed in. You can use 
  3049. WaterGate Manual       User Definitions                     Page 62
  3050. ---------------------------------------------------------------------
  3051. the Delete and Insert keys to change them.
  3052.  
  3053. Subscribed to
  3054. -------------
  3055.  
  3056. If you press Enter on this field, WtrConf will list all the areas to 
  3057. which this user is connected. You can use tagging (or not) and press 
  3058. the Delete key to disconnect one or more areas for this user. If you 
  3059. press Insert, WtrConf will list all the areas this user has 
  3060. permission to connect, but is not yet connected to. You can again 
  3061. use tagging (or not) and press Enter to connect the user to those 
  3062. areas. You can always press Escape to return to the previous list, 
  3063. or to the edit screen. While WtrConf is busy building the list, you 
  3064. can press Escape to abort it.
  3065.  
  3066. Passive
  3067. -------
  3068.  
  3069. If a user will be going on an extended holiday, it might be 
  3070. unnecessary to pack echomail for him. If you set this option to YES, 
  3071. the user is considered on a holiday.
  3072.  
  3073. The user can change this option via AreaFix with the "%PASSIVE" and 
  3074. "%ACTIVE" commands (for more information, see the chapter on 
  3075. AreaFix).
  3076.  
  3077. Address
  3078. -------
  3079.  
  3080. Type the user's FidoNet address here. You can use a full 5D address, 
  3081. like 2:280/802.33@bananas, although less will work perfectly fine as 
  3082. well. The minimum is zone, net, and node number.
  3083.  
  3084. If you want the 3D point address to be put in the archives that are 
  3085. created for this user, you have to define the user with the 
  3086. pointnet, instead of the full address!
  3087.  
  3088. SysOp
  3089. -----
  3090.  
  3091. Enter the full name of the SysOp at this address here. If WaterGate 
  3092. wants to report special things to that site, it will use this name 
  3093. in the To: field of the FidoNet message.
  3094.  
  3095. Packet password
  3096. ---------------
  3097.  
  3098. To increase security, you can enter a packet password in this field. 
  3099. It will be put in the outgoing packets that are sent to this user 
  3100. and, if "inbound security" is switched on, WaterGate will also check 
  3101. that packets from this user contain the correct password as well.
  3102.  
  3103. If the packet password is wrong, the packet is renamed to .PWD and a 
  3104. line is written to the logfile with both the expected and found 
  3105. passwords.
  3106.  
  3107. WaterGate Manual       User Definitions                     Page 63
  3108. ---------------------------------------------------------------------
  3109. AreaFix password
  3110. ----------------
  3111.  
  3112. AreaFix is a very powerful tool users can use to change settings or 
  3113. to (dis)connect areas. To make sure an authorized user is using it, 
  3114. a password is required. You can enter this password here. If you 
  3115. want to block somebody from using AreaFix, you can type something 
  3116. funny here.
  3117.  
  3118. AreaFix special
  3119. ---------------
  3120.  
  3121. You can set this option to YES for co-sysops. They will then be 
  3122. allowed to change their identify in AreaFix with the %FROM command 
  3123. and change settings for other users. This option is currently 
  3124. disabled in AreaFix (version 0.18) because of a rewrite of the 
  3125. AreaFix code.
  3126.  
  3127. There are some other maintenance commands in AreaFix that are 
  3128. enabled for users with this option set to YES. See the AreaFix 
  3129. chapter for more details.
  3130.  
  3131. Please be very careful with this option, because it can be a big 
  3132. security gap if it is set to YES for the wrong person!
  3133.  
  3134. New Area-create
  3135. ---------------
  3136.  
  3137. To save yourself a lot of typing, you can tell WaterGate to 
  3138. automatically create a new area when this user sends you a message 
  3139. in an area that is not yet present on your system. This new area 
  3140. will always be created in Group Z. You can then move the area to 
  3141. another group to allow other users to connect the area.
  3142.  
  3143. It is more than useful to enable this option for your uplink 
  3144. systems, because new areas will be created as soon as a message is 
  3145. received in them. If you also enable the automatic creation of a 
  3146. message base, you won't miss a message.
  3147.  
  3148. Be aware that this can create a lot of new areas when you enable 
  3149. this for your UUCP uplink. See the NEWSFILTER option of the 
  3150. ROUTE.TDB file for a solution.
  3151.  
  3152. Compression
  3153. -----------
  3154.  
  3155. This setting selects the way one or more .PKT files are archived in 
  3156. the outbound directory. The first six options speak for themselves. 
  3157. The option OP1 is your custom defined archiver and if you set it to 
  3158. PKT, the .PKT will not be archived.
  3159.  
  3160. Send format
  3161. -----------
  3162.  
  3163. There are different priorities for delivery of an archive to a 
  3164. system. You can select a priority in this field:
  3165. WaterGate Manual       User Definitions                     Page 64
  3166. ---------------------------------------------------------------------
  3167. Normal If you regularly call this node, set it to Normal. The 
  3168. archive will be sent when you call this system or this system calls 
  3169. you.
  3170.  
  3171. Hold
  3172. Hold for Pickup. If you set it to this option, this system must call 
  3173. you to pick up the archive.
  3174.  
  3175. Crash
  3176. If you want your mailer to call this system as soon as a new archive 
  3177. has been created, set it to this option.
  3178.  
  3179. Direct
  3180. If you set it to this option, you don't want to route this mail 
  3181. bundle via another node.
  3182.  
  3183. Of course, you will have to configure the way your mailer software 
  3184. (such as FrontDoor) responds to these flags.
  3185.  
  3186. Export AKA
  3187. ----------
  3188.  
  3189. You can use this option to select the system node number to use when 
  3190. sending messages to this uses. If you set it to automatic, then 
  3191. WtrGate will pick the best matching AKA by itself.
  3192.  
  3193. There are situations though where you want to select an AKA 
  3194. yourself. In that case, you can select it using this option.
  3195.  
  3196. Decode files
  3197. ------------
  3198.  
  3199. This is not implemented yet, but will work like the other Decode 
  3200. files options in the system and route the file to the user.
  3201.  
  3202. Max PKT length
  3203. --------------
  3204.  
  3205. It is possible to limit the size of a .PKT file. WaterGate checks 
  3206. the length of the .PKT after writing a message to it. If the size of 
  3207. the .PKT is bigger than this value, the .PKT file is closed and a 
  3208. new .PKT will be started. You can disable this option by setting it 
  3209. to 0.
  3210.  
  3211. UUCP name
  3212. ---------
  3213.  
  3214. This field and the following three fields all relate to the UUCP 
  3215. side of this user. You might not need these.
  3216.  
  3217. The UUCPname is the name of this system. The name can be 12 
  3218. characters long, but only the first seven characters are used. You 
  3219. must fill in this field if this system will be involved in UUCP, 
  3220. because all UUCP actions are based upon this name. The name must be 
  3221. unique within your system.
  3222.  
  3223. WaterGate Manual       User Definitions                     Page 65
  3224. ---------------------------------------------------------------------
  3225. World registered
  3226. ----------------
  3227.  
  3228. If the UUCP name entered above is World Wide Registered, you are 
  3229. allowed to use it in addresses. If this is not the case (most 
  3230. likely!), then leave it at NO. If you set it to YES, WaterGate will 
  3231. use the UUCP name in the From and Path: header lines.
  3232.  
  3233. Allow sub-domains
  3234. -----------------
  3235.  
  3236. If you want a user to be able to define sub-domains of his own 
  3237. domain, you need to set the 'Allow sub-domains' switch to YES. By 
  3238. doing so, you allow a user to process mail for his own set of 
  3239. sub-systems.
  3240.  
  3241. If you set this option to NO, WaterGate will only send messages to 
  3242. this system that are addressed to one of its domain addresses (or to 
  3243. its UUCP name, if it is world registered).
  3244.  
  3245. If you set this option to YES, WaterGate will also route messages 
  3246. for sub-domains of this system. This has the same functionality as 
  3247. adding the following line to your ROUTE.TDB file (example for the 
  3248. wsd system):
  3249.  
  3250. ROUTE-UUCP .wsd.wlink.nl wsd
  3251.  
  3252. Notice the dot in front of the domain name. The last part of this 
  3253. line is the UUCP name as defined in the user record.
  3254.  
  3255. You can also just add the domain address with the dot in front in 
  3256. the domain addresses list. This or a ROUTE-UUCP statement makes the 
  3257. switch useless! Future versions of WaterGate will also block messages
  3258. from this system if this switch is set to NO.
  3259.  
  3260. Domain addresses
  3261. ----------------
  3262.  
  3263. Apart from a UUCPname, the system must have one or more domain 
  3264. addresses as well. The first domain address is the most important 
  3265. one and WaterGate uses it when it has to have a domain address for 
  3266. this user. The other five addresses you can enter here are just 
  3267. aliases. If five are not enough, you can also use ROUTE-UUCP 
  3268. statements in the ROUTE.TDB file.
  3269. WaterGate Manual       User Definitions                     Page 66
  3270. ---------------------------------------------------------------------
  3271. UUCP style user
  3272. ---------------
  3273.  
  3274. A UUCP style user is a system with which you exchange messages via 
  3275. the UUCP protocol. You need a program like Waffle's UUCICO or the 
  3276. FX-UUCICO program to transfer the files. These files are set up in 
  3277. the spool directory structure, where every system has its own 
  3278. sub-directory named after its UUCP name.
  3279.  
  3280. WaterGate Manual       User Definitions                     Page 67
  3281. ---------------------------------------------------------------------
  3282.     +-[UUCP style user]---------------------------+
  3283.     | Organization      CyberSpace AB             |
  3284.     | Allowed groups    AB       JKL              |
  3285.     | Subscribed to     <press enter to see list> |
  3286.     | Passive           NO yes                    |
  3287.     | NewsFix password  verysecret                |
  3288.     | NewsFix special   NO yes                    |
  3289.     | New Area-create   NO yes                    |
  3290.     | Compress          none compress ZIP         |
  3291.     | Add batch header  no YES                    |
  3292.     | UUCP name         cyber                     |
  3293.     | World registered  NO yes                    |
  3294.     | Allow sub-domains NO yes                    |
  3295.     | Domain addresses  cyberspace.wline.se       |
  3296.     |                                             |
  3297.     |                                             |
  3298.     |                                             |
  3299.     |                                             |
  3300.     |                                             |
  3301.     +---------------------------------------------+
  3302.  
  3303. Most of these fields have been described in the "FidoNet style user" 
  3304. chapter. The NewsFix system is the same as the AreaFix system with a 
  3305. different name, but it lists the UUCP name of the area.
  3306.  
  3307. The only two new fields are Compress and Batch header.
  3308.  
  3309. Compress
  3310. --------
  3311.  
  3312. With this option you select how the news bundles (.DAT files in the 
  3313. spool directory) have to be archived, if at all. Mail bundles (also 
  3314. .DAT files) are never archived.
  3315.  
  3316. You can choose between the older COMPRESS or the newer GZIP (don't 
  3317. confuse it with PkZip!).
  3318.  
  3319. The setting of this switch is not important for extracting the 
  3320. archives in the spool directory. WaterGate uses a detection 
  3321. mechanism for that.
  3322.  
  3323. Add batch header
  3324. ----------------
  3325.  
  3326. The batch header is a special header that can be added for UNIX 
  3327. systems, so they can easily find out that the .DAT file is 
  3328. compressed.
  3329.  
  3330. WaterGate will add the header "cunbatch" for compressed file and 
  3331. "gunbatch" for G-zipped files. It is possible to override this with 
  3332. the GZIPBATCH statement in the ROUTE.TDB file, so you can set it to 
  3333. "zunbatch" for GZip compressed news batches.
  3334.  
  3335. For reliability issues, it is better not to set any header at all, 
  3336. or maybe not even compress news batches at all (V42.bis modems will 
  3337. compress it for you anyway). Certainly not towards your uplink UUCP 
  3338. WaterGate Manual       User Definitions                     Page 68
  3339. ---------------------------------------------------------------------
  3340. system. It is very easy to find problems between you and your 
  3341. downlinks, but not with your uplink.
  3342.  
  3343. Remark on the use of "New Area-create"
  3344. --------------------------------------
  3345.  
  3346. If you enable "New Area-create" for UUCP systems, WaterGate will 
  3347. create a new area as soon as it receives a message in a non-existent 
  3348. newsgroup.
  3349.  
  3350. But, since so many messages on UUCP are cross-posted, WaterGate 
  3351. checks for the existence of all the areas to which the message was 
  3352. cross-posted. If they don't exist, it creates the area.
  3353.  
  3354. Unfortunately, messages are not only cross-posted in the publicly 
  3355. know newsgroups, but sometimes also in local newsgroups. This means 
  3356. that you might end up with an area with a name like "buro.general".
  3357.  
  3358. WaterGate enables you to avoid the areas like "buro.general" by 
  3359. installing a proper "New Newsgroup Names Filter File". This will be 
  3360. described later in more detail, but this file basically consists of 
  3361. the newsgroup names that you do want to have created, or the first 
  3362. part of that newsgroup name, for example:
  3363.  
  3364. alt.
  3365. comp.
  3366. rec.
  3367.  
  3368. The file is more powerful, so a separate chapter will explain this in
  3369. more detail.
  3370. WaterGate Manual       User Definitions                     Page 69
  3371. ---------------------------------------------------------------------
  3372. Bag supplier
  3373. ------------
  3374.  
  3375. A BAG supplier is a system that creates files with the names like 
  3376. NEWS0001.BAG, NEWS0002.BAG, etc. These files are almost the same as 
  3377. UUCP .D files.
  3378.  
  3379. WtrGate supports BAG files with news, but also mail. WtrGate cannot 
  3380. create BAG files though.
  3381.  
  3382. They are used with systems that receive their Usenet news via a 
  3383. satellite link. It is possible to receive up to 600+ megabytes per 
  3384. day of news, without telephone costs!
  3385.  
  3386. There are also programs (like WinDis, Slurp and Changi) that download
  3387. messages from an NNTP (news) server and store them in a BAG file. The
  3388. created files do not necessarily have the extension "BAG".
  3389.  
  3390. WaterGate Manual       User Definitions                     Page 70
  3391. ---------------------------------------------------------------------
  3392.     +-[BAG supplier]-----------------------------------+
  3393.     | Organization      News from a dish!              |
  3394.     | Allowed groups    A                              |
  3395.     | Subscribed to     <press enter to see list>      |
  3396.     | New Area-create   no YES                         |
  3397.     | Search path       C:\NEWSPROG\ARTICLES\*.BAG     |
  3398.     | UUCP name         satdish                        |
  3399.     | Return system     wtrlnd                         |
  3400.     +--------------------------------------------------+
  3401.  
  3402. All fields in this screen have already been described in "FidoNet 
  3403. style user" and "UUCP style user". The only new field in this screen 
  3404. are the Search path and Return system.
  3405.  
  3406. Return system
  3407. -------------
  3408.  
  3409. Because the BAG system can only be used to receive messages, there 
  3410. has be a way to send messages back to the network. This is done via 
  3411. the "Return system". If a message is destined for the BAG system, it 
  3412. is sent to the Return system instead.
  3413.  
  3414. You have to create the return system as another user in the database 
  3415. (UUCP style users), fill in a UUCP name an enter the same UUCP name 
  3416. in this Return system field.
  3417.  
  3418. WARNING about the return system
  3419. -------------------------------
  3420.  
  3421. The return system MUST NOT be connected to all the areas. If you do 
  3422. this, the return system will receive the entire feed from the BAG 
  3423. supplier. And since this return system is usually your real UUCP 
  3424. uplink, they probably won't take kindly to receiving all this news 
  3425. from you as well. You might create a nice duplicate loop if you do 
  3426. this wrong, and that might be disastrous! So, be careful!
  3427. WaterGate Manual       User Definitions                     Page 71
  3428. ---------------------------------------------------------------------
  3429. SMTP interface user
  3430. -------------------
  3431.  
  3432. The SMTP style user is used to interface two directories where 
  3433. messages to and from another application are stored. UUCP also works 
  3434. on a file basis, but this is different.
  3435.  
  3436. SMTP is short for "Simple Mail Transport Protocol" and is the 
  3437. backbone protocol to deliver messages directly to the target system 
  3438. on the Internet. Notice that it is used for e-mail only and not for 
  3439. news (NNTP is for news).
  3440.  
  3441. The deliver functionality is not built into WaterGate (just like UUCP
  3442. isn't), so you need a special application to deliver the messages. 
  3443. Examples of these applications are WinDis and KA9Q. How to set up 
  3444. these applications is beyond the scope of this manual.
  3445.  
  3446. The following screen is used to set up the SMTP interface user.
  3447.  
  3448. WaterGate Manual       User Definitions                     Page 72
  3449. ---------------------------------------------------------------------
  3450.     +-----------------------------------------------+
  3451.     | Organization      WSD does it with SMTP       |
  3452.     | Passive           NO yes                      |
  3453.     | SMTP-In path      C:\SPOOL\RQUEUE             |
  3454.     | SMTP-Out path     C:\SPOOL\MQUEUE             |
  3455.     | UUCP name         smtp-if                     |
  3456.     | World registered  NO yes                      |
  3457.     | Allow sub-domains no YES                      |
  3458.     | Domain addresses                              |
  3459.     |                                               |
  3460.     +-----------------------------------------------+
  3461.  
  3462. Most of the fields have been described before. A few new fields and a
  3463. few notes on the other fields follow below.
  3464.  
  3465. SMTP-In path
  3466. ------------
  3467.  
  3468. SMTP-In path is the directory where the other application stores 
  3469. received messages. This can be the RQUEUE directory (for routing 
  3470. e-mail), but also the MAIL directory, depending on the setup of the 
  3471. SMTP application.
  3472.  
  3473. SMTP-Out path
  3474. -------------
  3475.  
  3476. The SMTP-Out path is the directory where WtrGate will store messages 
  3477. for the SMTP application to pick up and transport. This directory is 
  3478. usually referred to as the MQUEUE directory.
  3479.  
  3480. Some notes
  3481. ----------
  3482.  
  3483. The UUCP name is only there because WtrGate refers to a user by the 
  3484. Fido address or UUCP name.
  3485.  
  3486. World registered, Allow sub-domains and Domain addresses are not 
  3487. used for your uplink, but are there in case you use it for downlinks 
  3488. and WaterGate needs to know which messages to queue up.
  3489. WaterGate Manual       The List Server                      Page 73
  3490. ---------------------------------------------------------------------
  3491. The List Server
  3492. ---------------
  3493.  
  3494. The List Server is an automatic message distribution part of 
  3495. WaterGate that handles mailing lists. A mailing list is a list of 
  3496. e-mail and netmail addresses of people that are interested in that 
  3497. particular mailing list. If a message is distributed by the list 
  3498. server, everybody on that list receives a copy of the message.
  3499.  
  3500. So, you can see a mailing list as a more private echomail area or 
  3501. newsgroup. The advantage is that all the intermediate systems don't 
  3502. need to define that particular echo or newsgroup, and users who can 
  3503. receive mail but not news can also participate. WaterGate can handle 
  3504. up to 65000+ mailing lists.
  3505.  
  3506. The biggest advantage of mailing lists is the control of who can 
  3507. posts messages to it and not having to read all the spam postings 
  3508. that you find in the newsgroups nowadays.
  3509.  
  3510. Subscribing to a mailing list
  3511. -----------------------------
  3512.  
  3513. To subscribe to a mailing list, a user has to send a message to the 
  3514. list server, which can be addressed as "listserv" or "listserver", 
  3515. at any of your system AKAs or at any of your system domain addresses,
  3516. for example:
  3517.  
  3518. ListServer at 2:280/803
  3519. or
  3520. listserv@wsd.wlink.nl
  3521.  
  3522. You can request the list server to perform certain actions for you, 
  3523. just like AreaFix. It doesn't matter if you send a message to the 
  3524. list server via e-mail or via netmail. You use the same commands and 
  3525. you put them in the body of the message. The end of the message is 
  3526. indicated by a tear-line, so don't put any other lines in the 
  3527. message, like "Hi!" or "Bye,", because the list server will try to 
  3528. interpret them as commands.
  3529.  
  3530. The following commands are available:
  3531.  
  3532. LIST
  3533. Request the list server to send a list of all possible mailing lists 
  3534. available at this system.
  3535.  
  3536. HELP
  3537. Ask the list server to send you information on using the list server.
  3538. This information is also sent automatically if a user sends an 
  3539. unknown command (or something like "Hi!").
  3540.  
  3541. CONNECT listname
  3542. SUBSCRIBE listname
  3543. Two commands that both put the sender's address on the requested 
  3544. mailing list.
  3545.  
  3546. DISCONNECT listname
  3547. WaterGate Manual       The List Server                      Page 74
  3548. ---------------------------------------------------------------------
  3549. UNSUBSCRIBE listname
  3550. Two commands that remove the sender's address from the requested 
  3551. mailing list.
  3552.  
  3553. Notice that the sender's address, or more accurately the reply 
  3554. address, is very important for the list server, as it is put on the 
  3555. mailing list! This is especially important for a UUCP e-mail 
  3556. message, which has to have a proper Reply-To:, Sender:, or From: 
  3557. header (in that order).
  3558.  
  3559. As soon as a user receives a reply from the list server indicating 
  3560. that he has been put on the list, he can send a message to the 
  3561. mailing list to have it distributed. Since your system might have 
  3562. more than one mailing list, the message must be sent to the name of 
  3563. the mailing list, on one of your system AKAs or system domain 
  3564. addresses, for example:
  3565.  
  3566. WaterGate@wsd.wlink.nl
  3567. or
  3568. WaterGate at 2:280/803
  3569.  
  3570. Names of mailing lists are commonly given the extension -L, to 
  3571. indicate that it is a mailing list and not a normal user. Our own 
  3572. mailing list doesn't have a name like that yet, but if it did, the 
  3573. name would be WaterGate-l@wsd.wlink.nl.
  3574.  
  3575. Notice that you MUST NOT put the domain address in the name of the 
  3576. mailing list. Just "WaterGate-L" is all you have to enter. The first 
  3577. system domain address is added automatically.
  3578.  
  3579. Setting up a mailing list
  3580. -------------------------
  3581.  
  3582. To create your own mailing list, select the "Mailing list 
  3583. definitions" option from WtrConf's main menu. The names of all the 
  3584. mailing lists that are currently defined on your system will then be 
  3585. listed.
  3586.  
  3587. You can add a list by pressing the Insert key, or remove a list by 
  3588. pressing the Delete key. The Escape key returns you to the main menu.
  3589. If you want to edit a mailing list definition, you have to press the 
  3590. Enter key.
  3591.  
  3592. When editing a (new) mailing list definition, the following screen is
  3593. used:
  3594.  
  3595. WaterGate Manual       The List Server                      Page 75
  3596. ---------------------------------------------------------------------
  3597.     +-----------------------------------------------+
  3598.     | List name      WaterGate                      |
  3599.     | Description    WaterGate Support mailing list |
  3600.     | Welcome file   c:\wsd\wtrgate\wg_hej.txt      |
  3601.     | Private list   yes NO                         |
  3602.     | Only Known     yes NO                         |
  3603.     | Active         YES no                         |
  3604.     | AKA            2:280/803                      |
  3605.     |                                               |
  3606.     | Area name      WLINK.WATERGATE                |
  3607.     | Echo to List   YES no                         |
  3608.     | List to Echo   YES no                         |
  3609.     |                                               |
  3610.     | Subscribers    <enter to edit>                |
  3611.     | Default access FULL receive-only post-only    |
  3612.     +-----------------------------------------------+
  3613.  
  3614. List name
  3615. ---------
  3616.  
  3617. Enter the name of the mailing list here. This name has to be unique 
  3618. on your system, so make sure there are no users with the same name! 
  3619. You might want to put -L at the end of the name, to indicate that it 
  3620. is a mailing list and reduce the chance of it being the same as a 
  3621. user's e-mail address.
  3622.  
  3623. You MUST NOT type in a domain address here. The first system domain 
  3624. address is added automatically when sending to a UUCP system. 
  3625. Remember that the mailing list is accessible from within FidoNet as 
  3626. well, so don't type in a domain address!!
  3627.  
  3628. Description
  3629. -----------
  3630.  
  3631. You can use the description line to describe this mailing list. This 
  3632. line is used in the lists the list server sends in response to the 
  3633. LIST command.
  3634.  
  3635. Welcome file
  3636. ------------
  3637.  
  3638. The welcome file is sent when someone connects to this list. It 
  3639. should contain some information about the mailing list: the purpose, 
  3640. the language to use, and how to disconnect from it. The welcome file 
  3641. is a normal ASCII textfile and can contain tokens, just like the 
  3642. AreaFix and newsfix .TXT files. See the chapter "Installing the .TXT 
  3643. files" and appendix A for more information on tokens.
  3644.  
  3645. Private list
  3646. ------------
  3647.  
  3648. This toggle defines whether the list is private or not. Private lists
  3649. do not show up in the list of public mailing lists that people can 
  3650. connect to using the list server. You have to maintain (connect / 
  3651. disconnect people) private lists manually.
  3652.  
  3653. WaterGate Manual       The List Server                      Page 76
  3654. ---------------------------------------------------------------------
  3655. Only known
  3656. ----------
  3657.  
  3658. If you set this toggle to YES, only systems that are defined in your 
  3659. userbase can connect to the list. This is a middle way between public
  3660. access (Private list to NO) and complete manual access (Private list 
  3661. to YES).
  3662.  
  3663. Active
  3664. ------
  3665.  
  3666. This toggle determines whether this list is currently active. A 
  3667. disabled list is completely ignored and hidden by your system.
  3668.  
  3669. It won't show up in the lists and users can neither connect to nor 
  3670. disconnect from it.
  3671.  
  3672. AKA
  3673. ---
  3674.  
  3675. Select a system AKA for messages sent into FidoNet. This AKA is used 
  3676. as a From address for all messages sent by this list.
  3677.  
  3678. This will be changed in a future release, because the List Server is 
  3679. addressable on all your system AKAs. It will then use the most 
  3680. closely matching system AKA when replying to the message sender. 
  3681. This AKA will then be used when a message is sent to the list from 
  3682. UUCP and has to be translated to FidoNet. It is currently also used 
  3683. when a message is translated to an echomail message, but that will 
  3684. change also, since areas have an Origin AKA.
  3685.  
  3686. Area name
  3687. ---------
  3688.  
  3689. It is possible to connect a mailing list to an echomail area. This 
  3690. gives you several extra abilities, such as connecting a messagebase 
  3691. to a mailing list.
  3692.  
  3693. Echo to list
  3694. ------------
  3695.  
  3696. This toggle determines whether WaterGate allows message that were 
  3697. written in the area (or messagebase) to be sent out on the mailing 
  3698. list.
  3699.  
  3700. List to echo
  3701. ------------
  3702.  
  3703. If you set this option to YES, WaterGate will copy all the messages 
  3704. that were distributed via the mailing list to the area as well (and 
  3705. into the messagebase, if it is connected to one).
  3706.  
  3707. Default access
  3708. --------------
  3709.  
  3710. As described below. When a new user subscribes to the list, the 
  3711. WaterGate Manual       The List Server                      Page 77
  3712. ---------------------------------------------------------------------
  3713. access type in this field is used for the new entry.
  3714.  
  3715. Subscribers
  3716. -----------
  3717.  
  3718. If you press Enter on this field, you will be presented with a list 
  3719. of addresses of all the users that are currently connected to this 
  3720. mailing list. You can edit the list manually with the Insert, Delete,
  3721. and Enter keys.
  3722.  
  3723. When adding a new user, you have can select either a Fido user, UUCP 
  3724. user or Gateway user. The first can be reached using netmail, the 
  3725. second using UUCP or SMTP and the third is a bit special.
  3726.  
  3727. If you system doesn't have a connection to the Internet, but you are 
  3728. a sub-domain of a system running the gateway, and you are running a 
  3729. mailing list, then the address to reach the user on the Internet is 
  3730. via the gateway at your uplink. In that case, select Gateway user, 
  3731. enter the details of the gateway and the e-mail address of the user.
  3732.  
  3733. Using the access type you can block the user from posting messages 
  3734. via the mailing list (very useful for announcement lists), or you 
  3735. can configure a user to not receive any messages, but use the address
  3736. for posting messages only. The access type Full allows both posting 
  3737. and receiving.
  3738. WaterGate Manual       The Gateway                          Page 78
  3739. ---------------------------------------------------------------------
  3740. The Gateway
  3741. -----------
  3742.  
  3743. This chapter describes the operation and use of the gateway. The 
  3744. chapter "Gateway settings" (loads of pages back) describes how to 
  3745. configure it.
  3746.  
  3747. The gateway is where messages are translated between the FidoNet and 
  3748. UUCP formats. There are different gateways for the echomail-news 
  3749. translation and the netmail-mail translation.
  3750.  
  3751. The echomail-news gateway
  3752. -------------------------
  3753.  
  3754. This gateway is used automatically when a message is sent in an area 
  3755. from the FidoNet side and a UUCP style user is also connected to that
  3756. area; or the other way around, when a message is sent to an area from
  3757. the UUCP side and a FidoNet style user is connected to the area.
  3758.  
  3759. The message is then translated into the other format and sent out. 
  3760. When distributing a message in an area, the message is first sent to 
  3761. all connected users in the same style and if any users in the other 
  3762. style were found, the message is translated and then sent to all 
  3763. those users.
  3764.  
  3765. Gating echomail to news
  3766. -----------------------
  3767.  
  3768. When an echomail message is translated to a news message, a number of
  3769. actions are performed on the message. For example, all the kludge 
  3770. lines are removed, the high-ASCII values in the body of the message 
  3771. are translated using the ASCII conversion table, the date format is 
  3772. converted and the day-of-the-week and a time-zone are added, all 
  3773. addresses are translated, a valid UUCP header is put at the beginning
  3774. of the message, the tear-line, origin-line, PATH and SEEN-BY lines 
  3775. are removed, the paragraphs are split into separate lines and a 
  3776. signature might be added.
  3777.  
  3778. Gating news to echomail
  3779. -----------------------
  3780.  
  3781. When a news message has to be translated to an echomail message, a 
  3782. number of actions are performed on the message. Not as much as when 
  3783. translating in the other direction, but in short the header lines are
  3784. removed or copied to the Fido message as kludge lines or body text, 
  3785. the date format is converted, the addresses are converted, the body 
  3786. text is copied without change, special kludge lines are added, and a 
  3787. tear-line, origin line, PATH line, and SEEN-BY line are added.
  3788.  
  3789. What is important to know about this gateway is that it works 
  3790. automatically when it has to be used.
  3791.  
  3792. The netmail-mail gateway
  3793. ------------------------
  3794.  
  3795. This gateway handles the translation between the FidoNet netmail 
  3796. WaterGate Manual       The Gateway                          Page 79
  3797. ---------------------------------------------------------------------
  3798. style of messages and UUCP style mail messages. The translation is 
  3799. more complex than the echomail-news translation.
  3800.  
  3801. What is important to know about this gateway is that it does not 
  3802. always work automatically. If you use certain settings and addressing
  3803. formats, it works automatically. If you don't use them, you have to 
  3804. send your messages to a specific address and username to have it 
  3805. gated.
  3806.  
  3807. Using the gateway with netmail
  3808. ------------------------------
  3809.  
  3810. If you are on FidoNet and you want to send a message to someone via 
  3811. UUCP, you have to know the address. Say that I am "Ramon van der 
  3812. Winkel" at 2:280/802.33 and I want to send a message to 
  3813. martijn@dijkline.wlink.nl. I write a netmail message; it is then 
  3814. sent to the gateway (WaterGate), which translates it and forms it 
  3815. into a mail message, and then it is sent out on the UUCP side.
  3816.  
  3817. You can put the UUCP address (martijn@dijkline.wlink.nl) in the To: 
  3818. field of the netmail message. WaterGate will recognize it as a UUCP 
  3819. address and then automatically gate the message. The "Gateway TO:" 
  3820. option has to be set to YES to enable this.
  3821.  
  3822. There are occasions when the complete UUCP address does not fit in 
  3823. the To: field, for example when using QWK, which has a shorter To: 
  3824. field, or when the address is simply too long. In that case, you 
  3825. have to send the netmail to the WaterGate program and put the UUCP 
  3826. address on the first line of the body of the message, preceded by 
  3827. "To:", like this:
  3828.  
  3829.    To: martijn@dijkline.wlink.nl.
  3830.  
  3831. The AKA to which the netmail must be addressed is any of the system 
  3832. node numbers. The first field contains the AKA you want to use for 
  3833. the gateway. The second field holds the name of the user to which 
  3834. the netmail should be addressed. This defaults to "UUCP".
  3835.  
  3836. To return to the example above, the complete netmail message header 
  3837. would then be:
  3838.  
  3839. From: Ramon van der Winkel                   2:280/802.33
  3840. To:   UUCP                                      44:230/40
  3841. Subj: Test
  3842. ---------------------------------------------------------
  3843. TO: martijn@dijkline.wlink.nl
  3844.  
  3845. Hi Dijk!
  3846. ...
  3847.  
  3848. The name "UUCP" is set in the Gateway settings screen and the AKA is 
  3849. one of your system AKAs.
  3850.  
  3851. If the UUCP address fits in the To: field, you still have to address 
  3852. to any of your system node numbers (44:230/40 in this example). The 
  3853. netmail would then look like this:
  3854. WaterGate Manual       The Gateway                          Page 80
  3855. ---------------------------------------------------------------------
  3856. From: Ramon van der Winkel                   2:280/802.33
  3857. To:   martijn@dijkline.wlink.nl                 44:230/40
  3858. Subj: Test
  3859. ---------------------------------------------------------
  3860. Hi Dijk!
  3861. ...
  3862.  
  3863. FidoNet address to e-mail address translation
  3864. ---------------------------------------------
  3865.  
  3866. When a message is translated by the gateway, the FidoNet address of 
  3867. the sender of the message must be translated to a valid UUCP address.
  3868.  
  3869. Remember that a FidoNet address consists of the full name of the 
  3870. user (for example "Ramon van der Winkel") and an FidoNet address, 
  3871. also known as an AKA (for example 2:280/802.33).
  3872.  
  3873. The UUCP address consists of two parts: the username (for example 
  3874. "ramon") and the domain part (for example "wsd.wlink.nl"), which are 
  3875. added together to form the full e-mail address user@domain (for 
  3876. example ramon@wsd.wlink.nl).
  3877.  
  3878. When a netmail is received at your system that has to be gated, 
  3879. there are five possible situations:
  3880.  
  3881.   1. The user and his AKA are both unknown to your system.
  3882.   2. A FidoNet style user record exists for this AKA, without the 
  3883.      UUCPname and domain addresses filled in. The full name of the 
  3884.      user does not matter.
  3885.   3. A FidoNet style user record exists for this AKA, with the 
  3886.      UUCPname and domain addresses filled in. The full name of the 
  3887.      user does not matter.
  3888.   4. A mapping statement exists in the ROUTE.TDB file for this AKA. 
  3889.      The full name of the user does not matter.
  3890.   5. A mapping statement exists in the ROUTE.TDB file for this AKA 
  3891.      and this particular full name.
  3892.  
  3893. Each of these situations will be explained below, with examples of 
  3894. the e-mail address. Remember that the most important thing about the 
  3895. e-mail address is that it can be used to reply to the message. When 
  3896. somebody replies to the message, then all the required information 
  3897. has to be available in the UUCP address to translate it back to the 
  3898. full FidoNet address and user name.
  3899.  
  3900. Unknown AKA and full name
  3901. -------------------------
  3902.  
  3903. If the Fido user is not known to your system, or in other words, 
  3904. there is no Fido style user in your database with this AKA and there 
  3905. is no mapping statement in your ROUTE.TDB file, then WaterGate uses 
  3906. the most ugly form possible for the e-mail address.
  3907.  
  3908. The full name and the AKA of this user have to be reflected in the 
  3909. e-mail address. For example:
  3910.  
  3911. -----------------------------------------------------
  3912. WaterGate Manual       The Gateway                          Page 81
  3913. ---------------------------------------------------------------------
  3914. Gateway AKA:                 2:280/802
  3915. 1st system domain address:   wsd.wlink.nl
  3916.  
  3917. Full name:                   Ramon van der Winkel
  3918. AKA:                         2:512/10.5
  3919.  
  3920. After translation:
  3921.  
  3922.     Ramon_van_der_Winkel@z2.n512.f10.p5.wsd.wlink.nl
  3923.  
  3924. Or with small addresses set to YES:
  3925.  
  3926.     Ramon_van_der_Winkel@n512.f10.p5.wsd.wlink.nl
  3927. -----------------------------------------------------
  3928.  
  3929. User record, without domain address
  3930. -----------------------------------
  3931.  
  3932. If the AKA of the sending user is present in your userbase, that is, 
  3933. the user has sent the message from one of your neighboring systems, 
  3934. for example a point or node, but this record has no UUCPname and 
  3935. domain address, then the translation is just like the first 
  3936. situation, in which the user was not known to your system at all.
  3937.  
  3938. -----------------------------------------------------
  3939. Gateway AKA:                    2:280/802
  3940. 1st system domain address:      wsd.wlink.nl
  3941.  
  3942. Full name:                      Ramon van der Winkel
  3943. AKA:                            2:280/801
  3944.  
  3945. After translation:
  3946.  
  3947.     Ramon_van_der_Winkel@z2.n280.f801.wsd.wlink.nl
  3948.  
  3949. Or with small addresses set to YES:
  3950.  
  3951.     Ramon_van_der_Winkel@f801.wsd.wlink.nl
  3952. -----------------------------------------------------
  3953.  
  3954. The only difference is that the address of the user is probably 
  3955. closer to your address, because it is one of your neighbor systems. 
  3956. This can shorten the e-mail address.
  3957.  
  3958. User record with domain address
  3959. -------------------------------
  3960.  
  3961. In this case, a record exists in your userbase with the sending 
  3962. user's AKA, and you have defined a UUCPname and domain address for 
  3963. this user.
  3964.  
  3965. This improves the translation, because the AKA does not have to be 
  3966. put in the domain address anymore. The domain address from the user 
  3967. record is used instead.
  3968.  
  3969. Some examples:
  3970. WaterGate Manual       The Gateway                          Page 82
  3971. ---------------------------------------------------------------------
  3972. -----------------------------------------------------
  3973. Gateway AKA:                    2:280/802
  3974. 1st system domain address:      wlink.nl
  3975.  
  3976. Full name:                      Ramon van der Winkel
  3977. AKA:                            2:280/803.33
  3978. Domain address:                 wsd.wlink.nl
  3979.  
  3980. After translation:
  3981.  
  3982.     Ramon_van_der_Winkel@wsd.wlink.nl
  3983. -----------------------------------------------------
  3984.  
  3985. The same situation occurs when a local netmail is created with one 
  3986. of the system AKAs. WaterGate then uses the first system domain 
  3987. address. For example:
  3988.  
  3989. -----------------------------------------------------
  3990. Gateway AKA:                    2:280/802
  3991. 1st system domain address:      wlink.nl
  3992.  
  3993. Full name:                      Ramon van der Winkel
  3994. AKA:                            2:280/802
  3995.  
  3996. After translation:
  3997.  
  3998.     Ramon_van_der_Winkel@wlink.nl
  3999. -----------------------------------------------------
  4000.  
  4001. Notice that the only "ugly" thing about this address is the full 
  4002. name that has been translated. It is perfectly possible to use a 
  4003. full name like "ramon", though, instead of "Ramon van der Winkel".
  4004.  
  4005. Mapping statement, without full name
  4006. ------------------------------------
  4007.  
  4008. In this fourth situation it doesn't matter whether the user is known 
  4009. to your system. A MAP-UUCP statement in the ROUTE.TDB file tells 
  4010. WaterGate to translate the AKA to a domain address, just as if a 
  4011. user record existed with the UUCPname and domain addresses filled in.
  4012.  
  4013. This should be used for non-neighboring systems that you want to 
  4014. give special domain addresses for use in UUCP. Don't put bangpaths 
  4015. in the MAP-UUCP statements!
  4016.  
  4017. Example:
  4018.  
  4019. -----------------------------------------------------
  4020. Full name:                      Ramon van der Winkel
  4021. AKA:                            2:512/10.5
  4022.  
  4023. Mapping statement in the ROUTE.TDB file:
  4024.  
  4025.     MAP-UUCP faraway.wsd.wlink.nl 2:512/10.5
  4026.  
  4027. After translation:
  4028. WaterGate Manual       The Gateway                          Page 83
  4029. ---------------------------------------------------------------------
  4030.  
  4031.     Ramon_van_der_Winkel@faraway.wsd.wlink.nl
  4032. -----------------------------------------------------
  4033.  
  4034. Notice that the gateway AKA is no longer important for the address 
  4035. translation, and neither is the system domain address. The netmail 
  4036. still has to be sent to the gateway AKA, of course.
  4037.  
  4038. Mapping statement, with full name
  4039. ---------------------------------
  4040.  
  4041. All the examples up to now still had the original full name of the 
  4042. sender of the message as the user name of the e-mail address. This 
  4043. can be changed by using an extended MAP-UUCP statement in ROUTE.TDB.
  4044.  
  4045. Notice that it is not possible to use a MAP-FIDO statement to change 
  4046. the name of the sender, because MAP-FIDO statements only work on To: 
  4047. fields of a netmail message, not From: fields.
  4048.  
  4049. The extended MAP-UUCP mapping is actually the most common way to 
  4050. give a FidoNet user an e-mail address. An example follows:
  4051.  
  4052. -----------------------------------------------------
  4053. Full name:                      Ramon van der Winkel
  4054. AKA:                            2:512/10.5
  4055.  
  4056. Mapping statement in the ROUTE.TDB file:
  4057.  
  4058.     MAP-UUCP ramon@wsd.wlink.nl "Ramon van der Winkel"%2:512/10.5
  4059.  
  4060. After translation:
  4061.  
  4062.     ramon@wsd.wlink.nl
  4063. -----------------------------------------------------
  4064.  
  4065. Once again is the gateway AKA not important for the address 
  4066. translation.
  4067.  
  4068. Notice that the mapping statements we have used so far are working 
  4069. in both directions. What other options you have with these mapping 
  4070. statements will be explained later.
  4071.  
  4072. Notice that if you only use a mapping statement for a user with a 
  4073. user record and you don't fill in the UUCPname and domain address 
  4074. fields, this user can only be addressed with this e-mail address.
  4075.  
  4076. If you put a UUCPname and domain address in the user record, all 
  4077. mail to whatever user at that domain will be sent to the user's AKA 
  4078. (think about spelling problems). You might want to use a combination.
  4079.  
  4080. Creating UUCP message headers in the netmail
  4081. --------------------------------------------
  4082.  
  4083. WaterGate allows you to put header lines in the netmail message, 
  4084. which are then copied to the UUCP message. An example could be 
  4085. "X-Info: Oh coolness!".
  4086. WaterGate Manual       The Gateway                          Page 84
  4087. ---------------------------------------------------------------------
  4088. The headers have to be in the netmail messages as the first lines. 
  4089. If you have a To: line in the message, then that must be the first 
  4090. line of the message.
  4091.  
  4092. WaterGate only copies header lines up to an empty line or an invalid 
  4093. header line. All other lines go in the body of the UUCP message.
  4094.  
  4095. An valid UUCP header line start with a capital, has no spaces in it, 
  4096. ends with a colon (":") and a space and is followed with at least on 
  4097. line of text. The header line itself (before the colon) has to be 
  4098. two characters at least.
  4099.  
  4100. Further, WaterGate does not allow the following system header lines. 
  4101. These will be ignored.
  4102.  
  4103. To:
  4104. From:
  4105. Path:
  4106. Message-ID:
  4107. Subject:
  4108. Date:
  4109.  
  4110. But it is very valid to use any other header line, for example:
  4111.  
  4112. Reply-To:
  4113. Sender:
  4114. Approved:
  4115. References:
  4116. Newsgroups:
  4117. etc.
  4118.  
  4119. It is advised that you put "X-" before the header lines that you 
  4120. make up yourself.
  4121.  
  4122. Apart from just copying all the header lines and removing them from 
  4123. the body of the message, WaterGate now also deletes the first empty 
  4124. line it finds at the start of the message, or just behind the header 
  4125. lines. Usually, when you write a netmail to a UUCP recipient, you 
  4126. keep an empty line between the TO: and the "Hi!" line. This line 
  4127. used to show up in the mail message as an extra empty line after the 
  4128. empty line that separates the header lines and the body of the UUCP 
  4129. message. Not anymore. Personally, I find that this hides even more 
  4130. the fact that the message was created on a FidoNet system!
  4131.  
  4132. Using the gateway with mail
  4133. ---------------------------
  4134.  
  4135. If you are on UUCP and you want to send a message to somebody on 
  4136. FidoNet, you have to send it to his address. There are two general 
  4137. options for this. (In fact there are five options, as mentioned in 
  4138. "Using the gateway with netmail").
  4139.  
  4140. In the first case, the user has a mapping statement on a WaterGate 
  4141. system, which means that you can send the message to a UUCP address 
  4142. and let WaterGate takes care of the translation. Easy.
  4143.  
  4144. WaterGate Manual       The Gateway                          Page 85
  4145. ---------------------------------------------------------------------
  4146. In the other case, where you know only the user's full name and a 
  4147. FidoNet address, for example "Ramon van der Winkel" at 2:280/802.33, 
  4148. you have to use a special e-mail address that WaterGate will detect, 
  4149. after which it translates the message. This address looks like this:
  4150.  
  4151. Ramon_van_der_Winkel@z2.n280.f802.p33.wlink.nl
  4152.  
  4153. The full name has been put in front of the of the @-sign and the 
  4154. spaces in that name have been converted to underscores. This 
  4155. underscore can be configured, so don't be surprised if someone sends 
  4156. you a message from a WaterGate system with different characters 
  4157. there.
  4158.  
  4159. The part after the @-sign is the destination address. The Zone, Net, 
  4160. Node, and Point number have been coded in a special form, as above. 
  4161. The last part of the address has to be one of WaterGate's system 
  4162. domain addresses. This part is the address of a system you know that 
  4163. runs WaterGate.
  4164.  
  4165. Some systems also allow "fidonet.org" as the last part of the 
  4166. address. This only works if the UUCP provider and the smarthost in 
  4167. the neighborhood of that system know that it handles mail for that 
  4168. address. If this is not the case, the message will be sent to a site 
  4169. somewhere in the world (such as 1:1/31) that handles fidonet.org as 
  4170. well, after which it is translated to a FidoNet message and then has 
  4171. to travel all the way through FidoNet to get to its destination. That
  4172. is not what you want.
  4173.  
  4174. Please talk to your UUCP provider if you want to be a public 
  4175. UUCP-FidoNet gateway for your neighborhood. You have to add 
  4176. "fidonet.org" to your list of system domain addresses to get this to 
  4177. work.
  4178.  
  4179. The best way to find out the e-mail address of a FidoNet user is to 
  4180. let him send a message to you first, so you can see the address.
  4181. WaterGate Manual       The ROUTE.TDB file and its options   Page 86
  4182. ---------------------------------------------------------------------
  4183. The ROUTE.TDB file and its options
  4184. ----------------------------------
  4185.  
  4186. Although you can set a wide range of options in the configuration 
  4187. program, there is always need for more fields and more options which 
  4188. are difficult to put in a configuration program.
  4189.  
  4190. The ROUTE.TDB file is not only used to configure your system's 
  4191. routing, but has some additional functions. You can use it to:
  4192.  
  4193.    - Make routing exceptions for certain systems
  4194.    - Add signatures to mail and news messages
  4195.    - Map certain messages to other people
  4196.    - Allow special addresses for yourself or other people
  4197.    - Put restrictions on the use of the gateway
  4198.  
  4199. All this and more can be configured in the plain ASCII text file 
  4200. called ROUTE.TDB, that you can edit with MS-DOS's EDIT, for example.
  4201.  
  4202. In this ROUTE.TDB file, you can use the following commands:
  4203.  
  4204. ROUTE-FIDO
  4205.      This command is used to route Fido netmail messages through 
  4206.      certain systems.
  4207.  
  4208. ROUTE-UUCP
  4209.      This is nearly the same, but for routing UUCP mail messages 
  4210.      through different UUCP up- and downlinks.
  4211.  
  4212. MAP-FIDO
  4213.      When a netmail message is received for a certain user, you can 
  4214.      map it to another user, possibly at another Fido system.
  4215.  
  4216. MAP-UUCP
  4217.      Besides mapping UUCP mail messages to other systems, this 
  4218.      command is also used to assign different sender addresses to 
  4219.      Fido users.
  4220.  
  4221. FORBID-FIDO
  4222.      You can forbid a certain Fido user, a group of users, or 
  4223.      everybody to use the gateway.
  4224.  
  4225. ALLOW-FIDO
  4226.      After forbidding a group of people to use the gateway you can 
  4227.      make an exception for one or more users or systems.
  4228.  
  4229. SIGNATURE
  4230.      Most UUCP messages have a small signature part with some general
  4231.      (brag) information about the person writing the message or the 
  4232.      service provider. Use this command to automatically add 
  4233.      signature files to all messages created by a user or a system.
  4234.  
  4235. NEWSFILTER
  4236.      Name of the file that contains the newsgroup names that you 
  4237.      want to create automatically or not.
  4238.  
  4239. WaterGate Manual       The ROUTE.TDB file and its options   Page 87
  4240. ---------------------------------------------------------------------
  4241. SENDFILE
  4242.      You can use this statement to let WtrGate reply with the 
  4243.      contents of a file, when somebody send a message to specific 
  4244.      address. It is a simple file robot.
  4245.  
  4246. SAVE
  4247.      If you want to store messages that were sent  to a specific 
  4248.      address to a directory, then use this statement. You can use it 
  4249.      to make some automatic mechanism where a program processes the 
  4250.      messages that were saved.
  4251.  
  4252. SAVEFROM
  4253.      If you want to store messages that were sent  from a specific 
  4254.      address to a directory, then use this statement. You can use it 
  4255.      to make some automatic mechanism where a program processes the 
  4256.      messages that were saved.
  4257.  
  4258. BOUNCE
  4259.      If a system closes down or you don't want people to send mail 
  4260.      somewhere, you can use this statement to block their path. The 
  4261.      messages will be sent back with a specified reason.
  4262.  
  4263. BOUNCEFROM
  4264.      If somebody keeps on sending you crap mail, then you can use 
  4265.      this statement to bounce messages from that user automatically. 
  4266.      The messages will be sent back with a specified reason.
  4267.  
  4268. GZIPBATCH
  4269.      This can be used to set the first letter of the header that is 
  4270.      added to news batches that compressed with GZip.
  4271.  
  4272. FORCEPACK
  4273.      This is only used when running in FrontDoor mode and tells 
  4274.      WaterGate to put netmail for a certain user or system into .PKT 
  4275.      files, instead of storing them in the netmail area and letting 
  4276.      FrontDoor handle the delivery.
  4277.  
  4278. The following pages contain an long explanation of each of the 
  4279. statements. There are two other statement to do with the  Mail Tunnel
  4280.  functionality. See the separate chapter for more information.
  4281. WaterGate Manual       The ROUTE.TDB file and its options   Page 88
  4282. ---------------------------------------------------------------------
  4283. ROUTE-FIDO: Route Fido messages
  4284. -------------------------------
  4285.  
  4286. WaterGate currently implements only a very simple form of Fido 
  4287. routing:
  4288.  
  4289. ROUTE-FIDO <System_We_Route_Through> [<addresses> [...]]
  4290.  
  4291. ROUTE-FIDO 2:285/1        2:285/*
  4292. ROUTE-FIDO 2:280/802      2:* 140:*
  4293. ROUTE-FIDO 60:100/1       60:*
  4294.  
  4295. The destination system must be defined in the userbase. WaterGate 
  4296. will report an error if the system is unknown.
  4297.  
  4298. When a netmail message is encountered, WaterGate will check whether 
  4299. it is capable of transporting a message to its destination address. 
  4300. In the above example, a message for 2:255/1000 would be sent via 
  4301. 2:280/802, as would a message for 140:1000/100. However a message 
  4302. for 2:285/500 would be routed via 2:285/1
  4303.  
  4304. If WaterGate is incapable of routing a message, to 133:100/1 for 
  4305. example, an attempt is made to bounce the message to its sender.
  4306.  
  4307. If more than one routing statement can be used for a certain address,
  4308. the routing statement with the highest address match will be used. 
  4309. For example 2:285/1000 will be routed to 2:285/1 (two matches) and 
  4310. not via 2:280/802 (one match only).
  4311.  
  4312. If the system is in FrontDoor compatible mode, the routing statements
  4313. are not used. Instead, everything is put in the netmail directory, 
  4314. where FrontDoor/InterMail will take care of the routing.
  4315. WaterGate Manual       The ROUTE.TDB file and its options   Page 89
  4316. ---------------------------------------------------------------------
  4317. ROUTE-UUCP: Route UUCP messages
  4318. -------------------------------
  4319.  
  4320. The routing of UUCP mail can be implemented in two different ways. 
  4321. One is by configuring routings in WtrConf; the other is by using 
  4322. statements in the ROUTE.TDB file.
  4323.  
  4324. Usually, this is a proper way of setting up the system:
  4325.  
  4326. First, define your UUCP neighbors in the userbase. This is mandatory;
  4327. if your neighbors are not defined there, you cannot route messages to
  4328. or through them.
  4329.  
  4330. In these user records, you can also define their domain addresses, 
  4331. if any. There is a limit of 6 domain addresses for each neighbor.
  4332.  
  4333. Note that logically it does not matter if your neighbor is 
  4334. physically a FidoNet style node. This only affects the format of 
  4335. output created for your nodes, but is not of any importance for the 
  4336. names and routing of mail.
  4337.  
  4338. Next, define the systems that are more than one 'hop' away, i.e., 
  4339. not your neighbors, in your ROUTE.TDB file. The format of a 
  4340. UUCP-routing line in the ROUTE.TDB is:
  4341.  
  4342. ROUTE-UUCP <UUCP-name> <System-address>
  4343.  
  4344. where <UUCP-name> must be the UUCPname of one of your neighbors as 
  4345. defined in your userbase.
  4346.  
  4347. <System-address> can be:
  4348.  
  4349.    - The UUCPname of a system more than one hop away
  4350.    - The complete domain address of a system
  4351.    - A domain address with wildcards
  4352.  
  4353. If nodes under you have a world-registered UUCPname, you can use 
  4354. this UUCPname in bangpath addressing. If the name of the system 
  4355. through which a message should be routed is missing from the 
  4356. bangpath, a UUCPname routing statement can enable the mail to arrive 
  4357. anyway.
  4358.  
  4359. By using a complete domain address, you specifically route mail for 
  4360. that domain to one of your neighbors. The domain address must match 
  4361. 100% for it to work. This is the most widely used form of UUCP 
  4362. routing.
  4363.  
  4364. Note that this method can be used to add more domain names to one of 
  4365. your neighbors that is defined in the userbase, where you have space 
  4366. for only six domain addresses. On the other hand, you can also use 
  4367. those six lines as ROUTE-UUCP statements. Although it does work, we 
  4368. don't recommend using it, as you loose the complete view and control 
  4369. rather quickly.
  4370.  
  4371. Wildcards in the <System-address> allow you to route a complete 
  4372. hierarchy of domain-addresses to a certain neighbor without having to
  4373. WaterGate Manual       The ROUTE.TDB file and its options   Page 90
  4374. ---------------------------------------------------------------------
  4375. define each sub-node of that system separately. This allows your 
  4376. nodes to have sub-nodes of their own and they can create as many as 
  4377. they want. This is very useful when you or one of your nodes uses 
  4378. Fido-style addresses like "user@z2.n280.f802.p10.hisnode.wlink.nl".
  4379.  
  4380. You can then 'wildcard' the Fido segment of the complete domain 
  4381. address, so you won't have to define each Fido-style address he wants
  4382. to use.
  4383.  
  4384. There are currently two types of wildcards:
  4385.  
  4386.   1..yournode.wlink.nl
  4387.   2. *.yournode.wlink.nl
  4388.  
  4389. There is a very slight difference: Type 1 will route ALL addresses 
  4390. that end in 'yournode.wlink.nl', including sub-domains and the 
  4391. address "@yournode.wlink.nl" itself. Type 2 will ONLY route 
  4392. sub-domains, and will NOT route addresses like 
  4393. "user@yournode.wlink.nl".
  4394.  
  4395. Here are some example ROUTE-UUCP statements:
  4396.  
  4397. ROUTE-UUCP picard enterprize.space.nasa.gov
  4398.  
  4399.  
  4400. This ROUTE-UUCP line will route all mail for domain 
  4401. "enterprize.space.nasa.gov" to the system with the UUCPname "picard".
  4402. This system must be defined in your userbase.
  4403.  
  4404. E.g., addresses like "Mr.Spock@enterprize.space.nasa.gov" or 
  4405. "enterprize.space.nasa.gov!Mr.Spock" will be sent to the system 
  4406. named "picard". Subdomains are not allowed here and the 
  4407. domain-address will have to match 100%.
  4408.  
  4409. ROUTE-UUCP nixon *.WaterGate.wlink.nl
  4410.  
  4411. This line will route all mail destined for all sub-domains (and 
  4412. sub-domains only!) of "WaterGate.wlink.nl" to the system with 
  4413. UUCPname "nixon". Once again, "nixon" must be defined in the 
  4414. userbase.
  4415.  
  4416. For example:
  4417.  
  4418. "operator@phonetaps.WaterGate.wlink.nl"
  4419. or
  4420.  
  4421. "oval.office.WaterGate.wlink.nl!president"
  4422.  
  4423. will be routed to that system. It will NOT route addresses like 
  4424. "first.lady@WaterGate.wlink.nl" or "WaterGate.wlink.nl!authors".
  4425.  
  4426. ROUTE-UUCP rspca .rodent.net
  4427.  
  4428. This line will route all mail to users with domain addresses ending 
  4429. in "rodent.net" to the system with the UUCPname "rspca". For example,
  4430. "mickey.mouse@rodent.net" as well as "rabbits.rodent.net!bugs.bunny" 
  4431. WaterGate Manual       The ROUTE.TDB file and its options   Page 91
  4432. ---------------------------------------------------------------------
  4433. or "sylvester@cats.rodent.net" are routed to the "rspca" system, 
  4434. which has to be defined in your userbase.
  4435.  
  4436. ROUTE-UUCP picard xs4all
  4437.  
  4438. This last example routes all mail sent to "annie.user@xs4all" or 
  4439. "xs4all!xs4no1!mary.helen" to the system with UUCPname "picard". 
  4440. Because "xs4all" does not appear to be a domain style address, it 
  4441. makes us suspect this routing line is used to alias another UUCPname 
  4442. or to be able to route a UUCPname of a system that is not our 
  4443. neighbor.
  4444.  
  4445. About bangpaths
  4446. ---------------
  4447.  
  4448. Any system that is defined on UUCP has a bangpath, but not all 
  4449. systems have domain addresses. Therefore, bangpath addressing is 
  4450. always possible. Bangpaths are usually built up from UUCPnames (to 
  4451. keep them short), but a bangpath can also contain a domain addresses.
  4452.  
  4453. Internally, WaterGate converts all addresses to bangpaths. Then, for 
  4454. routing, it only looks at the part of the address that is in front of
  4455. the first bang (bang = !). If that part of the address turns out to 
  4456. be its own UUCPname, and the address contains more than one bang, it 
  4457. looks at the part between the first and the second bang. This 
  4458. algorithm allows a very powerful and flexible way of UUCP mail 
  4459. routing and, knowing this, you may find some ingenious and creative 
  4460. ways to perform all the routing you want.
  4461.  
  4462. Don't use bangpaths in MAP-UUCP statements where you use a username 
  4463. as well, because there is no way for WaterGate to find out if the 
  4464. last part of the bang-path is a username or the name of a system. 
  4465. Use domain addresses instead.
  4466.  
  4467. Routing things you cannot do in ROUTE.TDB
  4468. -----------------------------------------
  4469.  
  4470.  
  4471. You cannot put more than one <System-address> on a ROUTE-UUCP line. 
  4472. If you do this anyway, the line will be ignored. If you want more 
  4473. routings to the same UUCPname, then simply use as many lines as you 
  4474. need to route all system addresses and have them start with the same 
  4475. UUCPname.
  4476.  
  4477. You cannot chain the routing of UUCP-names. E.g.:
  4478.  
  4479. ROUTE-UUCP picard nixon
  4480. ROUTE-UUCP nixon  *.watergate.wlink.nl
  4481.  
  4482. This will NOT cause mail for *.WaterGate.wlink.nl to be routed to 
  4483. system "picard". WaterGate will try to route it directly to "nixon", 
  4484. even though "nixon" is routed to "picard". Instead, use something 
  4485. like this:
  4486.  
  4487. ROUTE-UUCP picard nixon
  4488. ROUTE-UUCP picard *.watergate.wlink.nl
  4489. WaterGate Manual       The ROUTE.TDB file and its options   Page 92
  4490. ---------------------------------------------------------------------
  4491. The reason is obvious: to prevent routing loops.
  4492.  
  4493. You cannot 'wildcard' bits and pieces of domain addresses. E.g.:
  4494.  
  4495. ROUTE-UUCP picard *gate.wlink.nl
  4496.  
  4497. This will NOT cause mail for "WaterGate.wlink.nl" or 
  4498. "water.gate.wlink.nl" to be routed to "picard". In fact, this may 
  4499. cause funny routing behavior.
  4500.  
  4501. A few last remarks about UUCP routing
  4502. -------------------------------------
  4503.  
  4504. If mail addresses contain capitalization, it will be kept intact, but
  4505. will be ignored for routing. Capitalization in your routing 
  4506. statements (make them wolverine if you wish) will also be ignored. 
  4507. In other words: the routing in WaterGate is case-insensitive.
  4508.  
  4509. All routing techniques discussed here about the ROUTE.TDB file also 
  4510. apply to the domain addresses defined in the userbase. Whatever you 
  4511. fill in there will have the same effect as defining just as many 
  4512. ROUTE-UUCP lines that all start with the <UUCP-name> of that user. 
  4513. However, it is wise to stick to the structure as proposed above.
  4514.  
  4515. If the format of your ROUTE-UUCP statements are incorrect, then this 
  4516. may (and often will) cause unpredictable routing behavior. So make 
  4517. sure that all your routing statements are correct. Keeping the 
  4518. definition structure as proposed above will help to keep things 
  4519. clear and obvious, so you can almost immediately locate the problem 
  4520. if any problem occurs.
  4521. WaterGate Manual       The ROUTE.TDB file and its options   Page 93
  4522. ---------------------------------------------------------------------
  4523. MAP-FIDO: Mapping Fido netmail messages
  4524. ---------------------------------------
  4525.  
  4526. The MAP-FIDO command is used to map received Fido netmail messages to
  4527. a different destination. For example, you can use this option to map 
  4528. messages for users that also have a point address to their point, or 
  4529. you can map messages for a Fido user to a different system, or even a
  4530. UUCP system. Note: It only works on the To: address of netmail 
  4531. messages.
  4532.  
  4533. There are two forms of this command:
  4534.  
  4535. MAP-FIDO "username"%fidoaddr "username"%fidoaddr
  4536. and
  4537. MAP-FIDO "username"%fidoaddr user@domain
  4538.  
  4539. Examples and an explanation of all the options follow:
  4540.  
  4541. 1.      MAP-FIDO "username" "username"
  4542.         MAP-FIDO "jaap aap" "SysOp"
  4543.  
  4544. Map netmail messages for a user on your system to a different user 
  4545. on your own system. All your system AKAs are accepted.
  4546.  
  4547. 2.      MAP-FIDO "username"           "username"%2:280/803
  4548.         MAP-FIDO "username"%2:280/802 "username"
  4549.         MAP-FIDO "username"%2:280/802 "username"%2:280/803
  4550.  
  4551. This is the same as for the first example, except that in the first 
  4552. line the message is now mapped to 2:280/803 instead of to your own 
  4553. system. The second line shows how a message passing through your 
  4554. system can be mapped to a local user, and the third sho
  4555.  
  4556. 3.      MAP-FIDO "username"           user@domain
  4557.         MAP-FIDO "username"%2:280/802 user@domain
  4558.         MAP-FIDO "jaap aap"           jaap.aap@network.nl
  4559.  
  4560. Received netmail can also be mapped to an Internet domain address; 
  4561. this is a one way conversion. Messages for jaap.aap@network.nl are 
  4562. not mapped back to the "jaap aap" fido user! Neither can you specify 
  4563. a domain address for the first parameter!
  4564.  
  4565. Order of precedence for MAP-FIDO
  4566. --------------------------------
  4567.  
  4568. When more than one MAP-FIDO statement could be applied to a netmail 
  4569. message, the mapping statement that will be used is selected as 
  4570. follows:
  4571.  
  4572. When only the address matches, the last mapping statement will be 
  4573. used. If a mapping statement exists that both matches the address and
  4574. the user name, then that mapping is used and the search is stopped.
  4575. WaterGate Manual       The ROUTE.TDB file and its options   Page 94
  4576. ---------------------------------------------------------------------
  4577. MAP-UUCP: Mapping UUCP mail messages
  4578. ------------------------------------
  4579.  
  4580. Mapping received UUCP mail messages is a little more complicated, as 
  4581. there are quite a lot of possible options. It is possible to map a 
  4582. message for a user to another user, or map all messages for a system 
  4583. to another system, or even to one user. Besides that, you can use the
  4584. information BACKWARDS to allow mapping of Fido addresses into domain 
  4585. addresses.
  4586.  
  4587. If you want these commands only to work from FidoNet to UUCP, you 
  4588. can use the prefix -FU. If you only want them to work from UUCP to 
  4589. FidoNet, you can use the prefix -UF. If you want them to work in both
  4590. directions, then don't use a prefix at all. The prefix has to be put 
  4591. on the line right after the command.
  4592.  
  4593. Note: unregistered users can only have five (5) MAP-UUCP statements 
  4594. in their route.tdb file. Extra MAP-UUCP statements are ignored and an
  4595. error message will be logged.
  4596.  
  4597. The two basic formats of this command are:
  4598.  
  4599. MAP-UUCP user@domain user@domain
  4600. MAP-UUCP user@domain "username"%fidoaddr
  4601.  
  4602. Examples and an explanation of each of the options follow below:
  4603.  
  4604. 1.      MAP-UUCP user@domain user@domain
  4605.  
  4606.         MAP-UUCP jaap.aap@network.nl sysop@network.nl
  4607.         MAP-UUCP jaap.aap@network.nl aapwork.nl
  4608.         MAP-UUCP jaap.aap@network.nl jaap.aap@aapwork.nl
  4609.  
  4610. The simplest map is to send all message from one user to another. 
  4611. Use this, for example, if you use multiple user names, but like to 
  4612. have all replies to 'SysOp'.
  4613.  
  4614. The last two options are equivalent, and will both deliver all 
  4615. messages for jaap.aap@network.nl to jaap.aap@aapwork.nl
  4616.  
  4617. 2.      MAP-UUCP domain user@domain
  4618.  
  4619.         MAP-UUCP oldserver.network.nl sysop@newserver.network.nl
  4620.  
  4621. Use this combination to send all messages for a complete domain to a 
  4622. single user at another system. This may come in handy when one of 
  4623. your downlinks changes its name or is temporarily off-line.
  4624.  
  4625. 3.      MAP-UUCP domain domain
  4626.  
  4627.         MAP-UUCP oldserver.network.nl newserver.network.nl
  4628.  
  4629. This will map all messages for all users of a domain to the same 
  4630. users at another domain address.
  4631.  
  4632. 4.      MAP-UUCP user@domain "username"
  4633. WaterGate Manual       The ROUTE.TDB file and its options   Page 95
  4634. ---------------------------------------------------------------------
  4635.         MAP-UUCP user@domain "username"%fidoaddr
  4636.         MAP-UUCP user@domain fidoaddr
  4637.  
  4638.         MAP-UUCP jaap@aapwork.nl "jaap aap"
  4639.         MAP-UUCP jaap@aapwork.nl "jaap aap"%2:280/802
  4640.         MAP-UUCP jaap@aapwork.nl 2:280/802
  4641.  
  4642. To map all messages for "user@domain" to a Fido system, simply 
  4643. specify the username at your own system, or the name of a user at 
  4644. another Fido system.
  4645.  
  4646. 5.      MAP-UUCP domain fidoaddr
  4647.         MAP-UUCP domain "username"%fidoaddr
  4648.  
  4649.         MAP-UUCP aapwork.nl 2:280/802
  4650.         MAP-UUCP aapwork.nl "sysop"%2:280/802
  4651.  
  4652. This combination will send all messages for an entire domain to a 
  4653. Fido system. The user names will be correctly translated into an 
  4654. acceptable Fido form. (Jaap_Aap -> Jaap Aap)
  4655.  
  4656. Order of precedence for MAP-UUCP
  4657. --------------------------------
  4658.  
  4659. When more than one mapping statement can be applied to a particular 
  4660. message, then only the first mapping statement is used.
  4661. WaterGate Manual       The ROUTE.TDB file and its options   Page 96
  4662. ---------------------------------------------------------------------
  4663. FORBID-FIDO/ALLOW-FIDO: Restricting the gateway
  4664. -----------------------------------------------
  4665.  
  4666. Acting as a public gateway may be a really rewarding thing for your 
  4667. soul, and a great thing for mankind; but it's not going to pay your 
  4668. monthly phone bills. By default, WaterGate will allow everyone to 
  4669. gate messages between a Fido and a UUCP network.
  4670.  
  4671. Add the following command to your ROUTE.TDB file:
  4672.  
  4673. FORBID-FIDO *
  4674.  
  4675. Now nobody, including yourself, is allowed to use the gateway; 
  4676. probably not exactly what you intended. Now relax this a little by 
  4677. giving some people access rights:
  4678.  
  4679. ALLOW-FIDO    2:280/*
  4680. ALLOW-FIDO    2:281/*
  4681. ALLOW-FIDO    2:280/802   Maarten User
  4682. ALLOW-FIDO    2:280/802   SysOp
  4683. ALLOW-FIDO    2:280/18.*
  4684. FORBID-FIDO    2:280/18    Jaap User
  4685.  
  4686. This allows everyone within the nets 280 & 281--except a special 
  4687. case, "Jaap User" at 2:280/18--to use the gateway. Plus 2:280/18 and 
  4688. its points, and "Maarten User" and "SysOp" at the system 2:280/802, 
  4689. are allowed to use the gateway.
  4690. WaterGate Manual       The ROUTE.TDB file and its options   Page 97
  4691. ---------------------------------------------------------------------
  4692. MAP-AREA: Receive a mailing list in an area
  4693. -------------------------------------------
  4694.  
  4695. Quite some users on your BBS might subscribe to a mailing list and 
  4696. receive this as netmail on the BBS. There is quite some flow in some 
  4697. of these mailing lists, so that means a lot of messages in your 
  4698. netmail area.
  4699.  
  4700. Also, if more users on your BBS want to receive the same mailing 
  4701. list, you receive more than one copy of these messages and they will 
  4702. all have to be stored in the netmail area until the users have read 
  4703. and deleted them.
  4704.  
  4705. It is not possible to set up a local mailing list and feed all 
  4706. incoming messages into that list, because the sender of the message 
  4707. must be connected to the local mailing list. And in most cases, the 
  4708. sending will be the original sender of the message that was 
  4709. distributed by the mailing list server. It is impossible to have all 
  4710. these names in your local mailing list setup.
  4711.  
  4712. If you don't like all these messages in your netmail area, or want 
  4713. to provide a mailing list for all your users, so you only have one 
  4714. copy of them, you have to take a look at the MAP-AREA statement.
  4715.  
  4716. Basically, what the MAP-AREA statement does is convert incoming 
  4717. e-mail into news. The news is then distributed, gated to echomail and
  4718. stored in your message base.
  4719.  
  4720. When you receive e-mail from a mailing list, you always receive that 
  4721. to the same name. Because the MAP-AREA statements takes all incoming 
  4722. mail to a certain address, you have to subscribe to the mailing list 
  4723. with a special "receiver" address, or else all your personal e-mail 
  4724. will be mapped as well.
  4725.  
  4726. For example, you are connected to the mailing list WaterGate, which 
  4727. is watergate@wsd.wline.se. You receive the mailing list messages as 
  4728. wg-receiver@bravo.com and you want this to be put in the area you 
  4729. created with the name WG-LIST. You then use the following statement 
  4730. in your ROUTE.TDB file:
  4731.  
  4732. MAP-AREA wg-receiver@bravo.com WG-LIST
  4733.  
  4734. Where WG-LIST can be either the Fido or Usenet name of the area.
  4735.  
  4736. Notice that this statement looks at the e-mail address that can be 
  4737. found in the .X file in your spool directory. Only MAP-UUCP 
  4738. statements are processed before the MAP-AREA is checked against that 
  4739. address.
  4740. WaterGate Manual       The ROUTE.TDB file and its options   Page 98
  4741. ---------------------------------------------------------------------
  4742. SIGNATURE: Adding signatures to a message
  4743. -----------------------------------------
  4744.  
  4745. Most messages found on UUCP have some kind of signature at the end, 
  4746. usually containing some information about the writer, the fact that 
  4747. whatever he or she wrote wasn't done with all senses intact, and that
  4748. his employer would be most surprised if someone took it seriously. 
  4749. Of course, this can be done in a million unique ways, and as long as 
  4750. the message isn't irritating (try to keep it at four lines or less), 
  4751. nobody will bother.
  4752.  
  4753. Since most Fido style BBS programs are unable to add signatures to a 
  4754. message by default, or aren't capable of using different ones for 
  4755. different users, you can have WaterGate do it automatically. All you 
  4756. need for each signature is a small text file containing the 
  4757. signature, and a definition in the ROUTE.TDB.
  4758.  
  4759. SIGNATURE filepath fidoaddr {username}
  4760.  
  4761. SIGNATURE D:\BBS\SIG\DEFAULT.SIG 2:280/802
  4762. SIGNATURE D:\BBS\SIG\SYSOP.SIG   2:280/802 Jaap Aap
  4763. SIGNATURE D:\BBS\SIG\NEOLINK.SIG 2:280/801
  4764.  
  4765. This will add DEFAULT.SIG to all messages gated from Fido to UUCP 
  4766. originating from 2:280/802, except that user "Jaap Aap" will get the 
  4767. SYSOP.SIG signature instead.
  4768.  
  4769. An example signature file:
  4770.  
  4771. ,----------------------------.------------------------------.
  4772. | Martijn Dijksterhuis       | Kids! Bringing about         |
  4773. | martijnd@dijkline.wlink.nl | Armageddon can be dangerous. |
  4774. | martijnd@htsa.aha.nl       | Do not attempt it at home    |
  4775. `----------------------------.------------------------------'
  4776.  
  4777. For automatic processing, the signature will be preceded by a 
  4778. tear-line, just as in fido messages. This tearline consists of two 
  4779. dashes followed by a space ("-- "). WaterGate automatically adds this
  4780. tearline, so there is no need to put it in the signature file.
  4781.  
  4782. When a netmail message is distributed by a mailing list and gated to 
  4783. e-mail then the signature of the sending user is not used, but the 
  4784. signature for the mailing list. This is the name of the mailing list 
  4785. the mailing list AKA. This allows you to put a special signature 
  4786. under these distributed netmails with - for example - information on 
  4787. how to disconnect.
  4788.  
  4789. If you don't like the above behaviour then you can send a netmail to 
  4790. through the gateway to the e-mail side of the mailing list. Your 
  4791. signature will be added to the gateway e-mail and is then distributed
  4792. by the mailing list. This requires that you are subscribed to the 
  4793. mailing list with your e-mail address.
  4794.  
  4795. On the next page is an excerpt about signatures from a classic 
  4796. article, which is regularly posted to news.announce.newusers by Gene 
  4797. Spafford.
  4798. WaterGate Manual       The ROUTE.TDB file and its options   Page 99
  4799. ---------------------------------------------------------------------
  4800. Q: Dear Miss Postnews: How long should my signature be? -- 
  4801. verbose@noisy
  4802.  
  4803. A: Dear Verbose: Please try and make your signature as long as you 
  4804. can. It's much more important than your article, of course, so try 
  4805. to have more lines of signature than actual text.
  4806.  
  4807. Try to include a large graphic made of ASCII characters, plus lots of
  4808. cute quotes and slogans. People will never tire of reading these 
  4809. pearls of wisdom again and again, and you will soon become 
  4810. personally associated with the joy each reader feels at seeing yet 
  4811. another delightful repeat of your signature.
  4812.  
  4813. Be sure as well to include a complete map of UUCP with each 
  4814. signature, to show how anybody can get mail to you from any site in 
  4815. the world. Be sure to include Internet gateways as well. Also tell 
  4816. people on your own site how to mail to you. Give independent 
  4817. addresses for Internet, UUCP, and BITNET, even if they're all the 
  4818. same.
  4819.  
  4820. Aside from your reply address, include your full name, company and 
  4821. organization. It's just common courtesy -- after all, in some 
  4822. newsreaders people have to type an *entire* keystroke to go back to 
  4823. the top of your article to see this information in the header.
  4824.  
  4825. By all means include your phone number and street address in every 
  4826. single article. People are always responding to UUCP articles with 
  4827. phone calls and letters. It would be silly to go to the extra 
  4828. trouble of including this information only in articles that need a 
  4829. response by conventional channels!
  4830. WaterGate Manual       The ROUTE.TDB file and its options   Page 100
  4831. ---------------------------------------------------------------------
  4832. NEWSFILTER: Auto-created newsgroups filter
  4833. ------------------------------------------
  4834.  
  4835. The NEWSFILTER statement points to a file that WaterGate uses to 
  4836. decide whether an area should be created automatically when a 
  4837. unknown newsgroup name is detected.
  4838.  
  4839. If you have "New area create" enabled in the user record of your 
  4840. UUCP uplink, then you might have noticed that WaterGate creates a lot
  4841. of new areas with funny names. Most of these areas you don't want to 
  4842. have at all.
  4843.  
  4844. The new newsgroups filter file allows you to tell WaterGate which 
  4845. newsgroups you want to have auto-created and which you do not. By 
  4846. default, WaterGate doesn't auto-create a newsgroup at all, until you 
  4847. install the NEWSFILTER file.
  4848.  
  4849. In this file, you can enter the complete or partial names of the 
  4850. newsgroups. There are special characters and wildcards that save you 
  4851. a lot of typing. People that are familiar with the Waffle FEEDS file 
  4852. will find some resemblance.
  4853.  
  4854. ALT.*
  4855. COMP.*
  4856. !COMP.OS.*
  4857.  
  4858. This file tells WaterGate that you don't want any newsgroups unless 
  4859. they start with ALT and COMP. But, you don't want the newsgroups that
  4860. start with COMP.OS.
  4861.  
  4862. The exclamation sign (!) is a "NOT" operator.
  4863.  
  4864. The extension dot plus asterisk (.*) means that you want all the 
  4865. newsgroups that start with that text, but not the newsgroup that 
  4866. starts with that name itself (for example "ALT").
  4867.  
  4868. Here is a somewhat more complicated example:
  4869.  
  4870. ALT.*
  4871. !ALT.BBS.*
  4872. ALT.BBS.WATERGATE
  4873. !ALT.BBS.WATERGATE.D.
  4874.  
  4875. This file basically tells WaterGate that you want all the newsgroups 
  4876. that start with ALT, but not the newsgroups that start with ALT.BBS, 
  4877. except newsgroups that start with ALT.BBS.WATERGATE, which you do 
  4878. want, but not that one special ALT.BBS.WATERGATE.D newsgroup.
  4879.  
  4880. The extension dot (.) means that you want the newsgroup with that 
  4881. name and only that newsgroup, not the newsgroup with names that start
  4882. with this. If the exclamation sign (!) is in front, it means that you
  4883. don't want that specific newsgroup.
  4884.  
  4885. You can also put comments in the filter file on any line you want by 
  4886. putting in a semi-colon (;) before the comment.
  4887.  
  4888. WaterGate Manual       The ROUTE.TDB file and its options   Page 101
  4889. ---------------------------------------------------------------------
  4890. A special case is when the NEWSFILTER statement is not present in 
  4891. the ROUTE.TDB file, or the news filter file could not be opened, or 
  4892. it is empty, or the ROUTE.TDB file is not present. In that case, no 
  4893. new newsgroup names filter statements are present. WaterGate then 
  4894. allows all new newsgroup names. That way, you don't have to setup the
  4895. filter file at once. This is reported in the log file at startup of 
  4896. WtrGate with the line "Allowing all new newsgroup names".
  4897.  
  4898. Logging information
  4899. -------------------
  4900.  
  4901. When your filter file gets big, it might become troublesome to find 
  4902. why a certain newsgroup name is rejected by WaterGate, while you 
  4903. want it, or why a certain newsgroup name is allowed, while you don't 
  4904. want it.
  4905.  
  4906. If you enable the "New newsgroup names check" log file option, 
  4907. WaterGate will tell you when it accepted or rejected a certain 
  4908. newsgroup and which line in the log file caused the decision.
  4909.  
  4910. For example,
  4911.  
  4912. ALT.*
  4913. !ALT.BBS.*
  4914. ALT.BBS.WATERGATE
  4915. !ALT.BBS.WATERGATE.D.
  4916.  
  4917. The newsgroup ALT.BBS.WATERGATE is accepted, because of line three. 
  4918. If line three was not there, then line two would have caused 
  4919. WaterGate to reject it. When WaterGate processes the filter file, it 
  4920. looks at every single line; if that line applies to the newsgroup 
  4921. name, the decision to accept or reject the newsgroup can be changed.
  4922. WaterGate Manual       The ROUTE.TDB file and its options   Page 102
  4923. ---------------------------------------------------------------------
  4924. SENDFILE: a simple file robot
  4925. -----------------------------
  4926.  
  4927. You can let WaterGate reply to a message automatically. You prepare 
  4928. the reply in a file that is put in the body of the reply message. If 
  4929. you want to send a file, you have to UU-encode it yourself first.
  4930.  
  4931. The sendfile statement works from both the UUCP side as the Fido 
  4932. side.
  4933.  
  4934. The format of this statement is:
  4935.  
  4936. SENDFILE <user name> <path to file>
  4937.  
  4938. For example:
  4939.  
  4940. SENDFILE watergate-info c:\wsd\wginfo.txt
  4941. SENDFILE wtrkit-req c:\wsd\wtrkit.txt
  4942.  
  4943. The e-mail address where people have to send their message to is the 
  4944. <user name> at any of your system domain addresses, for example 
  4945. watergate-info@wsd.wline.se.
  4946.  
  4947. For FidoNet, people have to send a netmail message to <user name> at 
  4948. one of your system AKAs, for example watergate-info at 2:200/111.
  4949. WaterGate Manual       The ROUTE.TDB file and its options   Page 103
  4950. ---------------------------------------------------------------------
  4951. BOUNCE: Send mail back with a reason
  4952. ------------------------------------
  4953.  
  4954. You can use the BOUNCE option for more than one purpose, but it is 
  4955. mostly used to inform people that certain e-mail addresses or even a 
  4956. whole system cannot be used anymore.
  4957.  
  4958. The e-mail address you have to put in the statement has to match 
  4959. only partially. Or in other words: the search string you put in the 
  4960. statement must appear in the e-mail address that is checked.
  4961.  
  4962. BOUNCEFROM is used to bounce messages sent  from a certain address, 
  4963. whereas BOUNCE checks who the message is sent to. The Sender:, 
  4964. Reply-To: and From: headers are checked for the search string and 
  4965. only a partial match is enough.
  4966.  
  4967. Not only is the message returned to the sender, but you can supply a 
  4968. reason as well. To support multiple languages, you have to put 
  4969. "Reason: " in front as well, if you wish.
  4970.  
  4971. The format for this statement is:
  4972.  
  4973. BOUNCE <partial e-mail address> "Reason"
  4974. BOUNCEFROM <partial e-mail address> "Reason"
  4975.  
  4976. For example:
  4977.  
  4978. BOUNCE wsd.wlink.nl "Reason: moved to Sweden"
  4979. BOUNCE ftpmail "Reason: ftpmail option is blocked!"
  4980. BOUNCE erik@wsd.wlink.nl "Reason: Account is closed!"
  4981. BOUNCEFROM sales "Reason: Not interested"
  4982.  
  4983. WaterGate Manual       The ROUTE.TDB file and its options   Page 104
  4984. ---------------------------------------------------------------------
  4985. SAVE: Write messages to disk
  4986. ----------------------------
  4987.  
  4988. With the SAVE and SAVEFROM statement you can save messages that were 
  4989. at your system to a file on disk. SAVE checks the address in the .X 
  4990. file and SAVEFROM the From:, Reply-To: and Sender: headers. The 
  4991. contents of the messages are completely saved in the file.
  4992.  
  4993. You can use it to let an external program process the message and 
  4994. send a reply, although there are no posting options in WaterGate yet.
  4995.  
  4996. For SAVE, the e-mail address that is checked has to match exactly. 
  4997. So, it is not possible to save all messages for a complete domain in 
  4998. a directory. This is to protect systems. On the other hand, SAVEFROM 
  4999. works on a partial address.
  5000.  
  5001. After the message has been saved, it is destroyed and not sent along.
  5002.  
  5003. The format of the SAVE and SAVEFROM statements are:
  5004.  
  5005. SAVE <e-mail address> <directory>
  5006. SAVEFROM <partial e-mail address> <directory>
  5007.  
  5008. For example:
  5009.  
  5010. SAVE ftpmail_receiver@wsd.wlink.nl c:\saved\
  5011. SAVEFROM mailer-daemon c:\saved
  5012.  
  5013. WaterGate Manual       The ROUTE.TDB file and its options   Page 105
  5014. ---------------------------------------------------------------------
  5015. MAP-UUCP and BOUNCE, SAVE, SENDFILE
  5016. -----------------------------------
  5017.  
  5018. The MAP-UUCP statement is processed before the BOUNCE, SAVE and 
  5019. SENDFILE options are checked. This way, you can "route" messages 
  5020. that are sent to different addresses all to one address and then use 
  5021. one bounce, save or sendfile statement.
  5022.  
  5023. Of course, it is perfectly possible to use more that one bounce, 
  5024. save or sendfile statement that have the save reason, use the same 
  5025. directory or point to the same file.
  5026. WaterGate Manual       The ROUTE.TDB file and its options   Page 106
  5027. ---------------------------------------------------------------------
  5028. GZIPBATCH
  5029. ---------
  5030.  
  5031. This option can be used to set the first letter of the header that 
  5032. can be added to news batches that have been compressed with GZip. 
  5033. The header is used on UNIX systems to find out that the batch is 
  5034. compressed. Actually, it is a command that executes a script.
  5035.  
  5036. This script is called "cunbatch" when the batch is compressed with 
  5037. normal compress. The names of the script for gzip compressed batches 
  5038. is differing though. Normally, it is gunbatch, but it can also be 
  5039. zunbatch.
  5040.  
  5041. To overcome this difference, you can set this letter system-wide 
  5042. (for all your UUCP users that you compress with gzip for and have the
  5043. "Add batch header" option set to YES).
  5044.  
  5045. The format of this line is:
  5046.  
  5047. GZIPBATCH <letter>
  5048.  
  5049. for example:
  5050.  
  5051. GZIPBATCH z
  5052.  
  5053. You normally don't need this statement.
  5054.  
  5055. FORCEPACK
  5056. ---------
  5057.  
  5058. This is only used when running in FrontDoor mode.
  5059.  
  5060. WaterGate normally writes netmails for users to the netmail area 
  5061. when configured to work together with FrontDoor. The actual delivery 
  5062. of the netmail is then handled by FrontDoor.
  5063.  
  5064. When configured for Binkley or d'Bridge compatibility, WaterGate 
  5065. packs up the netmails into .PKT files and doesn't write them to the 
  5066. netmail area.
  5067.  
  5068. You can use FORCEPACK to tell WaterGate to put netmails into a .PKT 
  5069. file, even when running in FrontDoor mode.
  5070.  
  5071. This is especially useful when using Mail Tunnel in combination with 
  5072. FrontDoor mode and basically then only way to get netmails delivered 
  5073. because the user in question would never dial in.
  5074.  
  5075. The format of this statement is:
  5076.  
  5077. FORCEPACK <node number>
  5078.  
  5079. for example:
  5080.  
  5081. FORCEPACK 2:200/111.15
  5082.  
  5083. WaterGate Manual       Mail Tunnel                          Page 107
  5084. ---------------------------------------------------------------------
  5085. Mail Tunnel
  5086. -----------
  5087.  
  5088. The Mail Tunnel functionality in WaterGate allows you to forward 
  5089. outbound archives for a FidoNet style user to an e-mail address and 
  5090. the other way around. The outbound archives are uu-encoded and put 
  5091. in an e-mail and sent to a system that could be on the other side of 
  5092. the world. That system then extracts the archive from the e-mail and 
  5093. processes it by putting it in the inbound. An identical path is used 
  5094. from the other system back to you.
  5095.  
  5096. Using this, you can exchange echomail with a system on the other side
  5097. of the world, without the expensive telephone costs.
  5098.  
  5099. Most important, this allows me, the author of WaterGate, to 
  5100. participate with several support echos without being a FidoNet 
  5101. system myself. Both systems simply use WaterGate (for full 
  5102. automatism) and send e-mail messages between them.
  5103.  
  5104. How do I set it up?
  5105. -------------------
  5106.  
  5107. Both systems use an identical setup, but with different e-mail 
  5108. addresses and FidoNet node numbers. You define the remote user as a 
  5109. normal FidoNet style user in WaterGate and connect it to the areas 
  5110. you want to send, and set the compression to use. You don't need to 
  5111. fill in a UUCP name or domain addresses.
  5112.  
  5113. You then put a TUNNEL-TO statement in the ROUTE.TDB file to tell 
  5114. WaterGate to send outbound archives for that user to a certain e-mail
  5115. address. This information is used during the PACK phase. A TUNNEL-TO 
  5116. statement looks like this:
  5117.  
  5118. TUNNEL-TO wsd2brazerko-tunnel@brazerko.com 2:200/111.15 wsd2brz
  5119.  
  5120. There are three parameters to this statement. The e-mail address is 
  5121. the address where the e-mails will be sent to. To make it easier to 
  5122. keep all the tunnel addresses apart, you could use a format like 
  5123. above, but your don't have to. Notice that this is the e-mail 
  5124. address at the other end, so don't put your own domain address after 
  5125. the @.
  5126.  
  5127. The second argument is the node number as defined in the user record 
  5128. in WtrConf for the user you are tunneling the archives for. The 
  5129. Packer checks the .PKT files for this address.
  5130.  
  5131. The third and last argument is the archive base filename. This name 
  5132. will be used instead of some cryptic number. The archives are created
  5133. in the outbound directory and the normal tracking of .SU0, SU1, etc. 
  5134. will be used. You can configure this filename for a number of 
  5135. reasons: so it doesn't collide with other archive names, so it 
  5136. remains useful and you can extract what it is for and last because 
  5137. the name is put in the e-mail and extracted like that on the other 
  5138. side.
  5139.  
  5140. So far for outgoing Tunnel Traffic. The next section explains how to 
  5141. WaterGate Manual       Mail Tunnel                          Page 108
  5142. ---------------------------------------------------------------------
  5143. process incoming traffic.
  5144.  
  5145. Incoming Tunnel Traffic
  5146. -----------------------
  5147.  
  5148. To complete the Mail Tunnel, you need to process incoming e-mail 
  5149. messages, extract the archives and put them in your inbound. You 
  5150. configure WaterGate to do this with the TUNNEL-FROM statement in the 
  5151. ROUTE.TDB file as follows:
  5152.  
  5153. TUNNEL-FROM brazerko2wsd-tunnel@wsd.wline.se c:\inbound\
  5154.  
  5155. This fairly simple statement tells WaterGate to check for messages 
  5156. address to the specified e-mail address, to discard the e-mail 
  5157. itself, but to extract the message in the e-mail and store them in 
  5158. the specified directory.
  5159.  
  5160. Notice that the e-mail specified must be on your own system, so 
  5161. after the @ you have one of your system domains. You have to specify 
  5162. the directory because you can have more than one inbound directory.
  5163.  
  5164. Once the archive is in your inbound directory, WaterGate will 
  5165. decompress it (assume it is compressed) and process the .PKT file. 
  5166. This requires that you configure the sender in under User 
  5167. Definitions in WtrConf as a FidoNet style user and connect that user 
  5168. to the areas you receive messages in.
  5169.  
  5170. A complete picture
  5171. ------------------
  5172.  
  5173. Following is a complete picture of how a bi-directional Mail Tunnel 
  5174. can be set up between two systems.
  5175.  
  5176. System wsd.wline.se
  5177.      System AKA 2:200/111
  5178.      User Definition for 2:200/111.20
  5179.      TUNNEL-TO wsd2brazerko-tunnel@brazerko.com 2:200/111.20 wsd2brz
  5180.      TUNNEL-FROM brazerko2wsd-tunnel@wsd.wline.se c:\inbound\
  5181.  
  5182. System brazerko.com
  5183.      System AKA 2:200/111.20
  5184.      User Definition for 2:200/111
  5185.      TUNNEL-TO brazerko2wsd-tunnel@wsd.wline.se 2:200/111 brz2wsd
  5186.      TUNNEL-FROM wsd2brazerko-tunnel@brazerko.com d:\inbound.sec\
  5187.  
  5188. WaterGate Manual       Mail Tunnel                          Page 109
  5189. ---------------------------------------------------------------------
  5190. A few notes
  5191. -----------
  5192.  
  5193.    - The Packer completely ignores the System Mailer (FrontDoor etc.)
  5194.      and everything related to that like file attach netmails, flow 
  5195.      files, correct outbound sub-directories, alternative outbound 
  5196.      directories, send format set in the user record, etc.
  5197.    - If you try to let a secondary tosser create the .PKT files, then
  5198.      you have to route them to WaterGate's node number so WaterGate 
  5199.      gets the .PKT files in the archive from the other tosser, where 
  5200.      after everything goes on as planned.
  5201.    - It is possible to exchange archives with netmail as well, 
  5202.      although WaterGate doesn't pack netmail automatically when 
  5203.      running in FrontDoor mode. You have to use the FORCEPACK 
  5204.      statement in the ROUTE.TDB file to tunnel netmails in that case.
  5205.    - Be careful with echomail to other zones. WaterGate cannot handle
  5206.      zone gating (yet!) and will not correctly handle inter-zone 
  5207.      echomail.
  5208.    - Make sure you set up AreaFix and Packet  passwords because 
  5209.      anybody can send an e-mail to you and fake a Mail Tunnel! If 
  5210.      you have defined the user in your mailer, then make sure you 
  5211.      use a Session password as well, even if the user is never going 
  5212.      to dial in.
  5213.  
  5214. WaterGate Manual       Using Areafix and newsfix            Page 110
  5215. ---------------------------------------------------------------------
  5216. Using AreaFix / newsfix
  5217. -----------------------
  5218.  
  5219. WaterGate has a built-in Area Manager to allow your users to easily 
  5220. maintain the areas in which they receive messages.
  5221.  
  5222. A Fido user has to send a netmail message to "AreaFix" at one of your
  5223. system AKAs. A UUCP user has to send a mail message to "newsfix" at 
  5224. one of your system domain addresses. For both, the password has to 
  5225. be in the subject line.
  5226.  
  5227. Examples:
  5228.  
  5229. [Fido Netmail]
  5230. From: Jaap Aap            2:280/802.67
  5231. To  : AreaFix            2:280/802
  5232. Subj: MyPassword
  5233. --------------------------------------------
  5234.  
  5235. +ARENA
  5236. -POINTS.028
  5237. %QUERY
  5238.  
  5239. [UUCP mail]
  5240. From: Jaap@TheNode.Network.Nl
  5241. To  : NewsFix@HostNode.NetWork.Nl
  5242. Subj: MyPassword
  5243. --------------------------------------------
  5244.  
  5245. +ARENA
  5246. -POINTS.028
  5247. %QUERY
  5248.  
  5249. The following commands are available:
  5250.  
  5251. AREANAME
  5252.      This will connect the area with the name "AREANAME" for the 
  5253.      requesting user, if the area exists and the user has access to 
  5254.      that area (it has to be in a group to which the user has 
  5255.      access). Optionally, you can use +AREANAME.
  5256.  
  5257. -AREANAME
  5258.      This will disconnect the user from the area with the name 
  5259.      "AREANAME". A user can always disconnect an area, even if he no 
  5260.      longer has access to connect it.
  5261.  
  5262. %+ALL
  5263.      This will connect the user to all the areas to which he has 
  5264.      access.
  5265.  
  5266. %-ALL
  5267.      This will disconnect the user from all the areas to which he is 
  5268.      connected.
  5269.  
  5270. %PASSIVE
  5271.      This will stop WaterGate from sending messages to this user. 
  5272. WaterGate Manual       Using Areafix and newsfix            Page 111
  5273. ---------------------------------------------------------------------
  5274.      This is especially useful when the user goes on a holiday, for 
  5275.      example, and doesn't want to have messages pile up. This will 
  5276.      not affect netmail or mail messages.
  5277.  
  5278. %ACTIVE
  5279.      If a node is ready to receive messages again, he can issue this 
  5280.      command, after which WaterGate will resume preparing mail for 
  5281.      this user.
  5282.  
  5283. %FROM <addr>
  5284.      If a user is allowed to do remote maintenance (see User 
  5285.      Configuration), then all modifications following the %FROM 
  5286.      line, will be made to the user specified in <addr>. Multiple 
  5287.      %FROM lines may be used in messages. If anything goes wrong 
  5288.      (e.g., a user with <addr> does not exist), all further commands 
  5289.      are ignored until the end of the message or another %FROM line.
  5290.      Note: this option is currently (version 0.92) disabled.
  5291.  
  5292. %HELP
  5293.      The user can issue this command to request help. WaterGate will 
  5294.      send a short list of all the commands that the user can use. If 
  5295.      the user is allowed to use a special AreaFix command, it will 
  5296.      also be shown.
  5297.  
  5298. %QUERY
  5299.      This will send a list of all the areas to which the user is 
  5300.      currently connected. The areas will be grouped and sorted, and 
  5301.      the list will also indicate whether a group is read-only.
  5302.  
  5303. %LIST
  5304.      WaterGate will create a list of all areas available to the node 
  5305.      and send it. The areas will be grouped and sorted, with the 
  5306.      descriptions of the areas from the Comment field in the area 
  5307.      record.
  5308.  
  5309. See the section " The text files " for information about the .TXT 
  5310. files you can use to override the standard help message and the 
  5311. headers and footers of the lists.
  5312.  
  5313. You can also use the old style query and list requests: putting -Q 
  5314. or -L after your password, with a space in between.
  5315. WaterGate Manual       Automatic file encoding / decoding   Page 112
  5316. ---------------------------------------------------------------------
  5317. Automatic file encoding / decoding
  5318. ----------------------------------
  5319.  
  5320. To send files to other users in FidoNet, you can use file attaches. 
  5321. To send files to other users on the Internet or attached to an 
  5322. article in a newsgroup, you encode the file and store it in the body 
  5323. of the message.
  5324.  
  5325. An encoded files in a message can look like this:
  5326.  
  5327. begin 666 wtrutil.dif
  5328. M1$E&7U8U5U12551)3"Y%6$4@\"@"`.'(W\2=A(@@`0```/__```!`/____\!
  5329. <etc>
  5330. >`/$H`````````(`=`6,#`@#E`6(#`@"M`6$#`@``
  5331. `
  5332. end
  5333.  
  5334. This is a so called "UU-encoded" file. The strange format is done 
  5335. because most news articles and e-mail messages can only contain 
  5336. 7-bit characters and no control characters or high-ASCII. A binary 
  5337. files contains a lot of 8-bit codes so this cannot be put into a 
  5338. message directly.
  5339.  
  5340. How it works
  5341. ------------
  5342.  
  5343. UU-encoding takes a group of 8-bits codes and converts it to four 
  5344. 6-bit codes. These 6 bits are then encoded in the message using 64 
  5345. (2^6) characters, amongst which A-Z, 0-9 and some others.
  5346.  
  5347. The difference between UU-encoding, XX-encoding and MIME encoding is 
  5348. basically the set of 64 characters used. There are different reasons 
  5349. to use a certain character set, basically to become independent of 
  5350. the transport mechanisms between the sender and recipient.
  5351.  
  5352. Encoding files
  5353. --------------
  5354.  
  5355. To help you send files along to other users on the Internet, 
  5356. WaterGate has the ability to automatically UU-encode an attached 
  5357. file when it gates a netmail message to an e-mail. All you have to 
  5358. do is write a netmail that will be gated and attach the file to that 
  5359. netmail (using a file attach).
  5360.  
  5361. WaterGate currently never deletes the gated files. Automatically 
  5362. gated files from your downlinks will be deleted in the future though.
  5363.  
  5364. The internal decoder is smart enough not to encode files that don't 
  5365. contain 8-bit codes, for example plain text files.
  5366.  
  5367. Decoding files
  5368. --------------
  5369.  
  5370. WaterGate can detect and extract an encoded file from a message when 
  5371. it writes the message to a message base. It can do this for all three
  5372. types of message bases.
  5373. WaterGate Manual       Automatic file encoding / decoding   Page 113
  5374. ---------------------------------------------------------------------
  5375. Decoding files is only done when you have specifically told 
  5376. WaterGate to do it for that area. For netmail it only decodes files 
  5377. for messages addressed to your system. It will never decode files 
  5378. for your users. This requires some more support that will follow in 
  5379. the future.
  5380.  
  5381. Each area can be configured to have its own path where the decoded 
  5382. files will be stored. This way you can keep the decoded files nicely 
  5383. separated per area.
  5384.  
  5385. Notice that decoding takes place when the message is imported into 
  5386. the message base, thus not when the message is gated from e-mail to 
  5387. netmail or news to echomail. This was done with several reasons in 
  5388. mind: the same message will be sent to several users, imported into 
  5389. an area and possible distributed via a mailing list. Not all 
  5390. "targets" want this file extracted, so it is extracted when the 
  5391. message is imported.
  5392.  
  5393. This means that an echomail or netmail message that contains a valid 
  5394. encoded file, but did not arrive via the Internet, can be decoded by 
  5395. WaterGate when that message is imported. If you are a Fidonet style 
  5396. user underneath some gateway, then you can now decode the files from 
  5397. messages you receive from that gateway!
  5398.  
  5399. Look for the options "Decode files" and "Files path" in the Area 
  5400. definitions and Fido message bases setup to enable the automatic 
  5401. decoding.
  5402.  
  5403. Tip: I have disabled decoding of files for my primary netmail area, 
  5404. but I have set up a Private Scan for my personal mail and connected 
  5405. it to a *.MSG base and enabled decoding on that message base.
  5406. WaterGate Manual       Customizing messages                 Page 114
  5407. ---------------------------------------------------------------------
  5408. Customizing messages
  5409. --------------------
  5410.  
  5411. WaterGate allows a great deal of flexibility in the language it uses 
  5412. towards your users. You can configure almost every aspect by two 
  5413. means: the language file and text response files.
  5414.  
  5415. Using this, you can change all replies to your local language, for 
  5416. example.
  5417. WaterGate Manual       Customizing messages                 Page 115
  5418. ---------------------------------------------------------------------
  5419. The language file
  5420. -----------------
  5421.  
  5422. This is the WTRGATE.LNG text file in your WaterGate system 
  5423. directory. Each "language line" contains a number, followed by text. 
  5424. Apart from that, you can have empty lines and comment lines, which 
  5425. start with a semi-colon (;).
  5426.  
  5427. The numbers in the language file are fixed and all numbers must be 
  5428. present, or else WaterGate won't start. Unknown numbers or duplicate 
  5429. entries are reported in the log file.
  5430.  
  5431. The text part of the language line can contain tokens that will be 
  5432. replaced with the real item when the line is used. These tokens are 
  5433. @1@, @2@ and so on.
  5434.  
  5435. There is no complete description of each language line, when it is 
  5436. used and what the tokens will be replaced with. Most of the lines 
  5437. are self-explanatory and the tokens can be guessed. You will find 
  5438. helping comments in the language file where the tokens are not 
  5439. directly clear.
  5440. WaterGate Manual       Customizing messages                 Page 116
  5441. ---------------------------------------------------------------------
  5442. The text files
  5443. --------------
  5444.  
  5445. Text files are optional. They have special names and the extension 
  5446. .TXT and are stored in the sub-directory TXTS of the WaterGate System
  5447. directory, for example C:\WTRGATE\TXTS\.
  5448.  
  5449. When present, these special files are used by WaterGate instead of 
  5450. the standard internal response messages, which are most of the time 
  5451. just one line.
  5452.  
  5453. With these text files you can customize WaterGate's responses, put in
  5454. more details about the response and of course translate them to your 
  5455. own language, if you which.
  5456.  
  5457. Apart from text, you can use special so-called "tokens" in these text
  5458. files. WaterGate replaces these tokens with special items, like the 
  5459. current date, etc. But before getting to the tokens, let's have a 
  5460. look at the different .TXT files.
  5461.  
  5462. Filenames
  5463. ---------
  5464.  
  5465. Currently, the following .TXT files are supported. Everywhere you see
  5466. "AreaFix", you can also substitute "newsfix".
  5467.  
  5468. AFLSRHDR.TXT
  5469.      AreaFix LiSt Request HeaDeR.
  5470.      Sent as the header of an AreaFix %LIST request reply-message.
  5471.  
  5472. AFLSRFTR.TXT
  5473.      AreaFix LiSt Request FooTeR.
  5474.      Sent as the footer of an AreaFix %LIST request reply-message.
  5475.  
  5476. AFQRRHDR.TXT
  5477.      AreaFix QueRy Request HeaDeR.
  5478.      Sent as the header of an Area Manager %QUERY request 
  5479.      reply-message.
  5480.  
  5481. AFQRRFTR.TXT
  5482.      AreaFix QueRy Request FooTeR.
  5483.      Sent as the footer of an Area Manager %QUERY request 
  5484.      reply-message.
  5485.  
  5486. BNCFIDO.TXT
  5487.      BouNCe FIDO.
  5488.      Sent when WaterGate is unable to transport a Fido message.
  5489.  
  5490. BNCGATE.TXT
  5491.      BouNCe GATEway.
  5492.      Sent when WaterGate is unable to transport a message through the
  5493.      gateway, such as when a FORBID-FIDO statement in the ROUTE.TDB 
  5494.      file prevents this user from using the gateway.
  5495.  
  5496. UNKAFUSR.TXT
  5497.      UNKnown AreaFix USeR.
  5498. WaterGate Manual       Customizing messages                 Page 117
  5499. ---------------------------------------------------------------------
  5500.      Sent when an unknown user sends a message to AreaFix. A user 
  5501.      must be defined in the userbase to use AreaFix.
  5502.  
  5503. WRNGAPWD.TXT
  5504.      WRoNG AreaFix PassWorD.
  5505.      Sent when an invalid password was found in a message to AreaFix.
  5506.      This is not sent back to the sending user, but to the SysOp of 
  5507.      that system.
  5508.  
  5509. LISTHELP.TXT
  5510.      Help file for a HELP command in a message to the List Server.
  5511.  
  5512. LISTHDR.TXT
  5513.      LIST HeaDeR.
  5514.      The header of the message created in response to a LIST command 
  5515.      in a message to the List Server.
  5516.  
  5517. LISTFTR.TXT
  5518.      LIST FooTeR.
  5519.      The footer of the message created in response to a LIST command 
  5520.      in a message to the List Server.
  5521.  
  5522. The following two files are not shared by AreaFix and newsfix; each 
  5523. has a separate file, so you can explain how to address AreaFix or 
  5524. newsfix and use the terms "echomail" and "newsgroups".
  5525.  
  5526. AREAFIX.TXT
  5527.      Sent as a response to a %HELP request for AreaFix.
  5528.  
  5529. NEWSFIX.TXT
  5530.      Sent as a response to a %HELP request for newsfix.
  5531.  
  5532. Tokens
  5533. ------
  5534.  
  5535. Each .TXT file may contain any of the tokens listed below, although 
  5536. some may be empty when used. PASSWORD, for example, will be an empty 
  5537. string when not used in conjunction with WRNGAPWD.TXT.
  5538.  
  5539. FirstUserName
  5540.      Message sender's first name
  5541.  
  5542. LastUserName
  5543.      Message sender's last name
  5544.  
  5545. UserName
  5546.      Message sender's full name
  5547.  
  5548. Subject
  5549.      Subject of sent message
  5550.  
  5551. Password
  5552.      AreaFix password found
  5553.  
  5554. Date
  5555.      Current system date
  5556. WaterGate Manual       Customizing messages                 Page 118
  5557. ---------------------------------------------------------------------
  5558. Time
  5559.      Current system time
  5560.  
  5561. WeekDay
  5562.      Current day of the week
  5563.  
  5564. FromAddress
  5565.      Address used by the original sender
  5566.  
  5567. ToAddress
  5568.      Address used by us for the reply
  5569.  
  5570. SysOp
  5571.      SysOp name found in the configuration
  5572.  
  5573. SysopFirst
  5574.      Sysop's first name
  5575.  
  5576. AreaName
  5577.      Current message area
  5578.  
  5579. PID
  5580.      Our program ID (WaterGate)
  5581.  
  5582. Version
  5583.      Current program revision (0.92)
  5584.  
  5585. To use a token, put it between @ characters. For example, if you want
  5586. to use the SysOp token, put the string @Sysop@ in your textfile.
  5587. WaterGate Manual       Using a secondary tosser             Page 119
  5588. ---------------------------------------------------------------------
  5589. Using a secondary tosser
  5590. ------------------------
  5591.  
  5592. This chapter explains how to use a second tosser together with 
  5593. WaterGate, as we receive a lot of questions about this.
  5594.  
  5595. Several options
  5596. ---------------
  5597.  
  5598.  
  5599. You might have a perfectly running FidoNet setup right now, with a 
  5600. tosser that takes care of your complete distribution. Now, you also 
  5601. want to connect to UUCP, and you want to use WaterGate to do this, 
  5602. but you don't want to replace your complete system. This is 
  5603. perfectly possible.
  5604.  
  5605. You can configure WaterGate to do all the translation work between 
  5606. Internet/Usenet (in UUCP, SMTP or BAG formats) and FidoNet while your
  5607. other tosser continues to take care of the distribution to all your 
  5608. nodes and points.
  5609.  
  5610. Even more simple and possible is to use WaterGate for the translation
  5611. of newsgroups and to toss them directly into your message bases for 
  5612. the BBS and not to distribute them to your points or to other nodes.
  5613.  
  5614. The best thing to do is to use a different zone for the newsgroups. 
  5615. waterGate will have its own node number and it will be very clear 
  5616. that netmail messages sent to that one address are going to another 
  5617. network, in this case to the Internet.
  5618.  
  5619. The basic construction
  5620. ----------------------
  5621.  
  5622. In WaterGate you define the node number for WaterGate under System 
  5623. Configuration. Then create a user (User Definitions) that represents 
  5624. your other tosser and fill in the correct node number. Give this user
  5625. access to the necessary group(s) and connect a few areas. You of 
  5626. course have to define a few areas first.
  5627.  
  5628. In your other tosser you also define a user that represents 
  5629. WaterGate, with the correct node number and connected to the 
  5630. necessary areas.
  5631.  
  5632. You, of course, have also created a user in WaterGate that represents
  5633. your Internet/Usenet provider and connected this user to the areas 
  5634. that will be delivered.
  5635.  
  5636. If you have now received some newsgroups from your provider, then 
  5637. start WTRGATE.EXE with the correct command line options (UUCP in 
  5638. most cases) to process these newsgroups. The user record for the 
  5639. provider makes it that the newsgroups arrive in the system and the 
  5640. user record for the other tosser makes it that the newsgroups are 
  5641. translated into echomail and sent out again as a .PKT file.
  5642.  
  5643. WaterGate Manual       Using a secondary tosser             Page 120
  5644. ---------------------------------------------------------------------
  5645. Connecting the inbound and outbound directories
  5646. -----------------------------------------------
  5647.  
  5648. Next you need to connect WaterGate's outbound to the inbound of your 
  5649. current tosser. Be careful not to set these to the same directory! If
  5650. you do, when WaterGate creates a .PKT file it might overwrite an 
  5651. already present .PKT file in that directory.
  5652.  
  5653. It is also dangerous to just copy all the .PKT files from WaterGate's
  5654. outbound to your tosser's inbound directory, again because you might 
  5655. overwrite an already present .PKT file.
  5656.  
  5657. The best way to solve this is to let WaterGate create an archive, 
  5658. then copy this file to the inbound of your tosser and let your tosser
  5659. extract the archive when it is ready for it. If it is a good tosser, 
  5660. it first processes all the .PKT files in the inbound directory and 
  5661. then starts to extract an archive, process all the .PKT files again, 
  5662. etc. so problems with .PKT filenames don't occur.
  5663.  
  5664. I hear you saying: but archiving takes a long time. You can force 
  5665. the compression factor to 0, so your archiver just puts all the .PKT 
  5666. files together. ARJ has the option -m0 for this. And, since there is 
  5667. no other point or node for which WaterGate has to create archives 
  5668. (with ARJ), it is no problem to change the arguments for ARJ.
  5669.  
  5670. If you do want to use ARJ for a node anyway, you might also use the 
  5671. OP1 option to compress for your other tosser and put the special 
  5672. command line arguments there.
  5673.  
  5674. On the way back, you can simply copy the .PKT files to WaterGate's 
  5675. inbound, but you probably don't know the names of these .PKT files 
  5676. because these are taken randomly. So, you have to archive everything 
  5677. again.
  5678.  
  5679. Don't point WaterGate's inbound directory to your other tosser's 
  5680. outbound directory, because WaterGate processes every archive it 
  5681. finds!
  5682.  
  5683. Including MailTunnel
  5684. --------------------
  5685.  
  5686. If you want to use the MailTunnel functionality in combination with a
  5687. secondary tosser, then you should consider the following.
  5688.  
  5689. WaterGate is currently not capable of detecting that an inbound .PKT 
  5690. file is for a Mail Tunnel user. So, you will have to route the 
  5691. netmails to the WaterGate system and send all echos as well. You 
  5692. then create the a normal FidoNet style user, connect the areas and 
  5693. set up the MailTunnel configuration in the ROUTE.TDB file.
  5694.  
  5695. Future version of WaterGate will have better support for this.
  5696. WaterGate Manual       Statistical information              Page 121
  5697. ---------------------------------------------------------------------
  5698. Statistical information
  5699. -----------------------
  5700.  
  5701. To let you know what passes through your system, WaterGate keeps 
  5702. track of all mail that passes through your system. It counts the 
  5703. size and amount of all messages - both received and sent - and 
  5704. stores that information in a separate logfile, called WTRGATE.STA by 
  5705. default. This file is located in the same directory you choose for 
  5706. the logfile. It also uses the name of the logfile, but with the 
  5707. extension .STA. New information is appended to it after each run of 
  5708. WaterGate.
  5709.  
  5710. Format of the WTRGATE.STA file
  5711. ------------------------------
  5712.  
  5713. A sample entry:
  5714.  
  5715. Statistics report of toss on Mon 05 Jun 1995 21:37:54
  5716.  m 1952 dutchman@mbh.network.nl (Jaap Aap%2:280/802.6)
  5717.  m 1210 sysop@waste.bin.network.nl (Jaap Aap%2:280/802.6)
  5718.  n 894 Jaap Aap%2:280/802.6 (dutchman@mbh.network.nl)
  5719.  u 0 0 0 0 0 0 0 49546 2:512/17@fidonet.org (Piet Hein)
  5720.  v 0 0 0 0 0 0 0 14 2:512/17@fidonet.org (Piet Hein)
  5721.  u 0 0 0 0 0 0 0 2263 LOCAL
  5722.  v 0 0 0 0 0 0 0 1 LOCAL
  5723.  b 2263 1 WLINK.TEST
  5724.  b 12778 3 HOLLAND.SYSOP
  5725.  b 733 1 POINTS.028
  5726.  b 3124 2 OVERIG.028
  5727.  b 6328 5 FS.028
  5728.  b 643 1 FDECHO.028
  5729.  b 3309 2 ALT.BBS.WATERGATE
  5730.  
  5731. The first line contains the date and time of the run. When a new 
  5732. statistics file is started, WaterGate will write a short explanation 
  5733. of the different lines, so the first line could be followed by a 
  5734. number of information lines, but these all start with a space.
  5735.  
  5736. Each line that starts with the letter 'u' or 'v' contains information
  5737. about a user that sent or received messages during the run. Only 
  5738. users that either sent or received messages are shown. The 'u' lines 
  5739. holds the number of bytes sent/received and the 'v' line holds the 
  5740. number of messages sent/received.
  5741.  
  5742. Each 'u' or 'v' line has the following fields:
  5743.  
  5744. MailTo
  5745.      UUCP mail sent to this node.
  5746.  
  5747. MailFrom
  5748.      UUCP mail received from this node.
  5749.  
  5750. NewsTo
  5751.      UUCP news sent to this node.
  5752.  
  5753. WaterGate Manual       Statistical information              Page 122
  5754. ---------------------------------------------------------------------
  5755. NewsFrom
  5756.      UUCP news sent received from this node.
  5757.  
  5758. NetTo
  5759.      FidoNet netmail sent to this node.
  5760.  
  5761. NetFrom
  5762.      FidoNet netmail received from this node.
  5763.  
  5764. EchoTo
  5765.      FidoNet echomail sent to this node.
  5766.  
  5767. EchoFrom
  5768.      FidoNet echomail received from this node.
  5769.  
  5770. Name
  5771.      User identification, plus SysOp name or UUCPname between the 
  5772.      braces. Messages that originate from a messagebase are counted 
  5773.      as "LOCAL".
  5774.  
  5775. The flow of messages in each area is shown in the 'b' lines. The old 
  5776. 'a' lines are now obsolete and not produced anymore. Every 'b' line 
  5777. contains the traffic in that area in number of bytes and number of 
  5778. messages and the name(s) of the area. Again, only areas that had any 
  5779. traffic are shown.
  5780.  
  5781. When an area has a different name for FidoNet and UUCP, then the 
  5782. UUCP name is listed as second name as well. The exact format of the 
  5783. 'b' line is:
  5784.  
  5785. "b" space <flow in bytes> space <number of messages> space <fidonet area name> [space <uucp area name>]
  5786.  
  5787. Between the [ and ] is optional.
  5788.  
  5789. Each netmail and mail message passing through your system is tracked 
  5790. in the 'm' (mail) and 'n' (netmail) lines. This is information on 
  5791. netmail and mail messages and their size. The MsgTo and MsgFrom field
  5792. contain the destination and source address of the message, for fido 
  5793. messages as username%fidoaddr and for UUCP messages as user@domain.
  5794.  
  5795. The WtrStat program
  5796. -------------------
  5797.  
  5798. You can use WTRSTAT.EXE, included in the WaterGate archive, to 
  5799. process the statistics file and make ASCII graphs of the message 
  5800. traffic passing through your system. If you want graphs number 1, 2, 
  5801. and 3 created, you can start the program with the following command:
  5802.  
  5803. C:\MAIL\LOGS>wtrstat wtrgate.sta 1 2 3
  5804.  
  5805. WTRSTAT will create the files GRAPH1.TXT, GRAPH2.TXT, and GRAPH3.TXT 
  5806. in the program startup directory.
  5807.  
  5808. WaterGate Manual       Statistical information              Page 123
  5809. ---------------------------------------------------------------------
  5810. Possible graphs
  5811. ---------------
  5812.  
  5813. The program is capable of proceeding eight different graphs:
  5814.  
  5815.   1. Message traffic in each of the areas.
  5816.   2. Volume and a graphical overview of the traffic from this system 
  5817.      to each other system.
  5818.   3. Volume and a graphical overview of the traffic from each other 
  5819.      system to this system.
  5820.   4. Flow in each area and the total flow in all of the areas, for as
  5821.      far as there has been a flow in those areas.
  5822.  
  5823. Graphs 5 through 8 are the same as graphs 1 through 4, but hold the 
  5824. information in number of messages, instead of number of (kilo)bytes.
  5825.  
  5826. Command line options
  5827. --------------------
  5828.  
  5829. The program accepts a number of options as well. Options have to be 
  5830. preceded with a forward slash (/) or dash (-). The following options 
  5831. can be used:
  5832.  
  5833. -Dn
  5834.      "Days". Makes a report for the last <n> days, starting to count 
  5835.      with today=1. -D1 creates a report over today, up to the last 
  5836.      data added. -D7 creates a report for the last week, including 
  5837.      today.
  5838.  
  5839. -A
  5840.      "Amount". Sorts the area listing in graph 4 or 8 by amount, in 
  5841.      descending order. The area with the highest number of messages 
  5842.      or bytes is shown first, and so on.
  5843.  
  5844. -N
  5845.      "Name" With this option you can tell WtrStat to use the UUCP 
  5846.      area name in graphs 4 and 8, instead of the FidoNet areaname.
  5847.  
  5848. The WtrStat program will first get and check all the command line 
  5849. options, then read the statistics file to gather all the information 
  5850. and finally create all the requested graphs.
  5851. WaterGate Manual       WtrTest                              Page 124
  5852. ---------------------------------------------------------------------
  5853. Configuration testing with WtrTest
  5854. ----------------------------------
  5855.  
  5856. The program WtrTest can be used to simply test your WaterGate setup. 
  5857. You can use it to simulate a netmail or e-mail and then simulate the 
  5858. processing and whether everything works as expected.
  5859.  
  5860. WtrTest contains most of the code WtrGate uses, but doesn't touch 
  5861. the message bases, inbound, outbound, spool directories and the like.
  5862. Instead, it sets up a netmail or e-mail as it would be after arriving
  5863. at your system and then processes it. The log file shows exactly 
  5864. what happens to the message. Notice that WtrTest is a rather 
  5865. technical and powerful program, but you can't damage anything. You 
  5866. just learn and debug your configs.
  5867.  
  5868. After starting WtrTest you select from a short menu to either 
  5869. simulate a netmail or simulate an e-mail.
  5870.  
  5871. Simulating a netmail
  5872. --------------------
  5873.  
  5874. For the netmail you can fill in the following fields:
  5875.  
  5876. From User
  5877.      You type in the user name as it would show on the From line of 
  5878.      a netmail message.
  5879.  
  5880. From AKA
  5881.      This is the node number of the system on which the message was 
  5882.      created.
  5883.  
  5884. To User
  5885.      The name of the user who is to receive the message. If you want 
  5886.      to test the gateway, then you can type an e-mail address here, 
  5887.      or else address it to the user "UUCP" (providing you havn't 
  5888.      changed the gateway user).
  5889.  
  5890. To AKA
  5891.      The node number of the system where the message must be 
  5892.      processed. You usually set this to one of your own node numbers.
  5893.  
  5894. To: line
  5895.      If you send a netmail to a gateway (like WaterGate), then you 
  5896.      can put the e-mail address of the recipient on the first line 
  5897.      of the message, preceeded by "To: ". You can simulate this by 
  5898.      typing the e-mail address here. This is an optional field.
  5899.  
  5900. You then press F10 and WtrTest will process the message. If you have 
  5901. enabled debug logging in WtrConf then you will see each step the 
  5902. message takes until it finally is ready to leave your system again. 
  5903. At that point WtrTest tells you where it would go and what the 
  5904. important parameters were.
  5905. WaterGate Manual       WtrTest                              Page 125
  5906. ---------------------------------------------------------------------
  5907. Simulating an e-mail
  5908. --------------------
  5909.  
  5910. For the e-mail you want to simulate you can fill in the following 
  5911. fields:
  5912.  
  5913. .X file: rmail
  5914.      Fill in the e-mail address of the recipient of this message as 
  5915.      it would show when a .X file is received with UUCP. You could 
  5916.      type in your own e-mail address. This is the most important 
  5917.      information for WtrGate when it receives a message. Notice that 
  5918.      you can test the full e-mail address lookup function by typing 
  5919.      in a user name without the @ and domain address.
  5920.  
  5921. .D file: To:
  5922.      Type the contents of the To: header as you would find it in the 
  5923.      .D file you received using UUCP. This information is used by 
  5924.      WaterGate when it gates the message to FidoNet format. The full 
  5925.      name is extracted from this line (if present). An example of 
  5926.      this line would could be "ramon@wsd.wline.se (Ramon van der 
  5927.      Winkel)". This e-mail address normally matches the one you 
  5928.      typed in in the previous line.
  5929.  
  5930. .D file: From:
  5931.      This is the e-mail address and full name (same format as the 
  5932.      previous line) of the one sending this e-mail. This can be any 
  5933.      address and the information is used when bouncing a message or 
  5934.      gating it to FidoNet format.
  5935.  
  5936. After filling in all the fields you press F10 to start the 
  5937. simulation.
  5938. WaterGate Manual       WtrTest                              Page 126
  5939. ---------------------------------------------------------------------
  5940. Routing tables
  5941. --------------
  5942.  
  5943. There is one more menu option in WtrTest called "Routing tables". If 
  5944. you select this option then WtrTest will show you a list with the 
  5945. three important tables that control the mapping of addresses and 
  5946. routing of e-mails to the correct domains.
  5947.  
  5948. The first table it shows is directly related to the MAP-FIDO 
  5949. statements. The second contains the MAP-UUCP statements and the 
  5950. third the ROUTE-UUCP statements.
  5951.  
  5952. The reason for showing these tables is because WtrGate automatically 
  5953. adds some of these statements with information it extracts from the 
  5954. user records. A lot of people don't know this and they add 
  5955. unnecessary MAP-UUCP statements.
  5956.  
  5957. Also, if you run into trouble with a certain address, then you can 
  5958. track these tables and see what WaterGate exactly uses for the 
  5959. decision making.
  5960. WaterGate Manual       WtrUtil                              Page 127
  5961. ---------------------------------------------------------------------
  5962. WtrUtil
  5963. -------
  5964.  
  5965. WaterGate comes with a maintenance utility program called WtrUtil 
  5966. that you can use to  trim message bases, the  log files and  
  5967. WaterGate's own databases.
  5968.  
  5969. To do this, you start WtrUtil and simply select one of the options 
  5970. from the menu. Alternatively, you can use command line options to 
  5971. start on of the options from - for example - a batchfile. Using the 
  5972. same command line functionality, you can also tell WtrUtil to only 
  5973. work on areas that are in a certain group or a certain set of groups.
  5974. That way, you can limit the number of areas involved.
  5975.  
  5976. See the section on command line options for details.
  5977. WaterGate Manual       WtrUtil                              Page 128
  5978. ---------------------------------------------------------------------
  5979. Message base maintenance
  5980. ------------------------
  5981.  
  5982. Regarding message bases it can perform four important tasks:
  5983.  
  5984.    - Link
  5985.    - Re-index
  5986.    - Renumber
  5987.    - Purge
  5988.  
  5989. Link
  5990. ----
  5991.  
  5992. To allow your BBS program or message editor to follow discussion 
  5993. threads in a certain area, you need to have your messages linked 
  5994. together. This basically means that one message points to the next 
  5995. one.
  5996.  
  5997. You can use WtrUtil to link all message in all areas you have 
  5998. configured in WtrConf with a *.MSG, JAM or Squish message base 
  5999. selected.
  6000.  
  6001. WtrUtil uses different techniques to link messages, depending on the 
  6002. capabilities of a message base type. Usually the MSGID and REPLYID 
  6003. kludges are used.
  6004.  
  6005. Re-index
  6006. --------
  6007.  
  6008. JAM and Squish message bases have an index file that allows your 
  6009. editor or BBS program to bring up a list of the messages present in 
  6010. an area, without browsing every single message.
  6011.  
  6012. It is sometimes necessary to reconstruct these index files, and you 
  6013. can do that with WtrUtil.
  6014.  
  6015. Renumber
  6016. --------
  6017.  
  6018. If a add a message to an area, it gets a message number. Normally, 
  6019. every new messages gets the next highest message number. If you then 
  6020. delete a lot of messages, you get gaps that cannot be reused.
  6021.  
  6022. You can use WtrUtil to renumber all the messages in an area so they 
  6023. get sequential numbers again, starting with one. This also prevents 
  6024. an overflow of the highest possible message number.
  6025.  
  6026. In case of JAM, the index file has an entry for each message number, 
  6027. whether an actual message with that number is present or not. This 
  6028. means it costs disk space (only eight bytes per message number 
  6029. though) for not present messages. It can save some disk spaces to 
  6030. renumber your area. WtrUtil advises you to do so during an Index or 
  6031. Purge action if it finds a gap of at least 8k (1000 messages) in the 
  6032. index file. The gap from 1 to the first actually message doesn't 
  6033. "cost" any space though.
  6034.  
  6035. WaterGate Manual       WtrUtil                              Page 129
  6036. ---------------------------------------------------------------------
  6037. At this moment you can only renumber *.MSG and JAM areas.
  6038.  
  6039. Purge
  6040. -----
  6041.  
  6042. You can't just keep on getting new message in a certain area. You 
  6043. wouldn't have the harddisk space to store them. So, you have to 
  6044. delete some messages every now and then. But if you delete messages, 
  6045. you get unused gaps in the message base, which you have to get rid 
  6046. of as well.
  6047.  
  6048. You can use WtrUtil to do all that automatically. It removes messages
  6049. that have been deleted and recovers the storage space. You can also 
  6050. let WtrUtil delete messages that are too old (more than n days old), 
  6051. or simply set an upper limit on the number of messages you want to 
  6052. keep in an area.
  6053.  
  6054. You set the maximum age of a message and the maximum number of 
  6055. messages you want in a messages base in WtrConf under the area 
  6056. definition. WtrUtil reads that information.
  6057.  
  6058. The Squish and *.MSG purge code is a bit hard when deleting messages 
  6059. by number. *.MSG deletes the oldest message numbers and Squish the 
  6060. first ones in the base. Only JAM scans the base again and kills the 
  6061. oldest messages (by date), instead of the first ones in the base.
  6062. WaterGate Manual       WtrUtil                              Page 130
  6063. ---------------------------------------------------------------------
  6064. Log file and statistics file maintenance
  6065. ----------------------------------------
  6066.  
  6067. You can use WtrUtil to trim the size of the WaterGate log file and 
  6068. statistics file. This functionality is called "shrinking" and you 
  6069. tell it the number of days of history you want to keep.
  6070.  
  6071. For example, telling it to "shrink 6" keeps today's information plus 
  6072. six days of history.
  6073.  
  6074. There are different option for shrinking the log file and the 
  6075. statistics file. Here are some examples:
  6076.  
  6077. WTRUTIL SHRINKLOG 6
  6078. WTRUTIL SHRINKSTA 14
  6079.  
  6080. It is advisable, especially when you have just started with WtrGate, 
  6081. to enable Debug Logging (all possible information) and to put a 
  6082. shrinklog statement in a batch file to keep the log file from 
  6083. growing enormous.
  6084. WaterGate Manual       WtrUtil                              Page 131
  6085. ---------------------------------------------------------------------
  6086. WaterGate's Databases
  6087. ---------------------
  6088.  
  6089. WaterGate's uses a number of database files where it keeps all the 
  6090. configuration information: system setup, users, areas, groups, 
  6091. mailing lists, which user wants which area, etc.
  6092.  
  6093. These databases are in binary format and you need the WtrConf program
  6094. to make changes, although WtrGate updates information as well. For 
  6095. example, when a user connects an area using the built in AreaFix 
  6096. Manager or subscribes to a mailing list with the Mailing List Server.
  6097.  
  6098. When you delete users and areas, or when you unsubscribe users or 
  6099. areas, then WaterGate doesn't re-use the space because it would 
  6100. require additional information and processing time. It is so much 
  6101. easier to simply add new information at the end of the database.
  6102.  
  6103. To clean up these gaps, you use the Databases Maintenance option 
  6104. built into WtrUtil. It basically creates a new database and removes 
  6105. the empty space. Apart from that, it does a few other important 
  6106. things.
  6107.  
  6108. Pack databases has built in detection for some forms of corruption 
  6109. in the database structure. It can detect short loops in subscription 
  6110. lists (list of areas a user is subscribed to) and doesn't hang. 
  6111. Instead, it scans all the areas to see what the rest of the list 
  6112. should be and restores that list. Notice that WtrConf contains the 
  6113. same kind of detection mechanisms and warns you that it can't 
  6114. continue and you should pack the databases immediately.
  6115.  
  6116. You start this option by selecting "Pack Databases" from the menu or 
  6117. by typing the following on the command line.
  6118.  
  6119. WTRUTIL DATABASE
  6120.  
  6121. To safe a bit of time, you can prevent WtrUtil from sorting the 
  6122. areas by adding the command line option -NOSORT. This is mainly 
  6123. intended for very slow systems with a lot of areas. Faster systems 
  6124. should always sort the areas.
  6125.  
  6126. This is especially important if you have a lot of areas, because 
  6127. WtrConf sorts the areas when presenting a list and that can take a 
  6128. bit of time as well. Pre-sorting with WtrUtil saves you from waiting 
  6129. while WtrConf sorts that list with 3000 areas.
  6130.  
  6131. The databases are AREABASE.TDB, USERBASE.TDB, SUBSCRIPT.TDB, 
  6132. LISTSRV.TDB, GROUPS.TDB and WTRCFG.TDB. A copy of packed databases is
  6133. kept in .OLD files.
  6134. WaterGate Manual       Overlaid WtrGate                     Page 132
  6135. ---------------------------------------------------------------------
  6136. Overlaid WtrGate
  6137. ----------------
  6138.  
  6139. WTRGATE.EXE is quite big (over 350kB) and with only 640kB of 
  6140. conventional ("low") memory you can run into problems. WaterGate 
  6141. requires about 450 to 500kB of free low memory or it won't even 
  6142. start.
  6143.  
  6144. While processing messages, it needs the low memory as well to store 
  6145. a transient message in. If the message is too big for the amount of 
  6146. free memory, then it will use the swapfile, but that means an 
  6147. overhead for swapping the message out and reading it back later on.
  6148.  
  6149. Some people simply don't have 450kB of free memory because they use 
  6150. (for example) DesqView. A special version of WtrGate was created for 
  6151. these users: WTRGATEO.EXE, which uses the overlay file WTRGATEO.OVR.
  6152.  
  6153. What is an overlay file?
  6154. ------------------------
  6155.  
  6156. Normally a program is completely loaded into memory when you run it 
  6157. and all code sits there and occupies memory space, whether it is used
  6158. or not. The overlay version only loads code permanently that is used 
  6159. a lot. The rest is in the .OVR file instead of the .EXE file.
  6160.  
  6161. Blocks of code that are needed are loaded from the .OVR file and 
  6162. discarded (removed from memory) if other code has to be loaded. 
  6163. Multiple blocks of code can be loaded at once for efficiency and the 
  6164. most used blocks of code will be kept as long as possible.
  6165.  
  6166. Loading and discarding blocks of code costs a bit of time and disk 
  6167. access. WTRGATEO.EXE is 200kB smaller as the full blown executable 
  6168. and the rest is kept in the overlay file WTRGATEO.OVR.
  6169.  
  6170. Of these extra 200kB of low memory you get, 80kB is normally reserved
  6171. to load bits of pieces of code into. This means that you get 125k 
  6172. more free low memory for storing messages or loading other programs 
  6173. into.
  6174.  
  6175. To reduce disk access, the overlay version tries to load the .OVR 
  6176. file into EMS memory so it can copy pieces of code from memory 
  6177. instead of loading it from disk all the time. So, if you have some 
  6178. EMS memory installed, then WtrGate/O will use that automatically. If 
  6179. you are using DesqView or a real OS, then you are able to set the 
  6180. amount of EMS a dos box gets, so you can enable the loading of the 
  6181. .OVR file into EMS.
  6182.  
  6183. Tuning parameters
  6184. -----------------
  6185.  
  6186. If the .OVR file is used a lot (depending on your configuration), 
  6187. then the processing slows down a lot. WtrGate/O writes a line to the 
  6188. logfile when you exit the program to indicate the number of loads 
  6189. from the .OVR file. If this number is high (>250) then you might 
  6190. want to increase the 80kB low memory region that is used to load 
  6191. blocks of code into.
  6192. WaterGate Manual       Overlaid WtrGate                     Page 133
  6193. ---------------------------------------------------------------------
  6194. You can use -OVR25K and -OVR50K on the command line to increase the 
  6195. memory area a bit. This should reduce the load counter, but never to 
  6196. 0 though.
  6197. WaterGate Manual       Translating from other programs      Page 134
  6198. ---------------------------------------------------------------------
  6199. Translating from other programs
  6200. -------------------------------
  6201.  
  6202. WaterGate is capable of adding information to its userbase and 
  6203. areabase from other programs. Currently, it can directly process 
  6204. information from GEcho, Waffle, and Squish. To do this, start the 
  6205. "WTRCONF" program and select the "Import/Export" menu option.
  6206. WaterGate Manual       Translating from other programs      Page 135
  6207. ---------------------------------------------------------------------
  6208. Adding information from GEcho v1.02
  6209. -----------------------------------
  6210.  
  6211. First select the "Import GEcho Nodes file NODEFILE.GE" option. This 
  6212. will read all node information stored by GEcho and add this 
  6213. information to the WaterGate userbase. You have to do this first 
  6214. because without this node information WaterGate is unable to add 
  6215. these nodes to the area lists when using the "Import GEcho Areas 
  6216. file AREAFILE.GE" that you can use next.
  6217. WaterGate Manual       Translating from other programs      Page 136
  6218. ---------------------------------------------------------------------
  6219. Adding information from Waffle
  6220. ------------------------------
  6221.  
  6222. First select the "Import Usenet newsgroups file", this file is 
  6223. usually located in your waffle\system directory and contains a 
  6224. listing of all the areas available on your system.
  6225.  
  6226. A typical file looks like :
  6227.  
  6228. # All Areas that I ever want to read (Not!)
  6229. #
  6230. COMP.BBS.PROGRAMS
  6231. COMP.BBS.NONEWBBS  /mod=jaap@aap.network.nl
  6232.  
  6233. Next import the SYSTEMS file, containing the names of all systems 
  6234. that are directly linked to your system.
  6235.  
  6236. A typical SYSTEMS file entry looks like:
  6237.  
  6238. steambt  Any  g modemx tosystem 02995-9111 myid password
  6239.  
  6240. All information about mail that needs to be sent through another 
  6241. system is located in the PATHS file, usually located in the 
  6242. "WAFFLE\UUCP" directory. Use "Import Usenet Paths" file to import 
  6243. this information.
  6244.  
  6245. To add areas for certain users, select "Import UUCICO Feeds". This 
  6246. file contains information about all users connected to certain areas.
  6247.  
  6248. A typical entry is:
  6249.  
  6250. steambk /batch comp.bbs.*,alt.bbs.*
  6251. steambt /batch *
  6252.  
  6253. WaterGate Manual       Translating from other programs      Page 137
  6254. ---------------------------------------------------------------------
  6255. Adding Information from Squish
  6256. ------------------------------
  6257.  
  6258. WaterGate is capable of scanning a Squish configuration file 
  6259. (usually SQUISH.CFG) for 'EchoArea' lines. A typical Squish EchoArea 
  6260. entry:
  6261.  
  6262. EchoArea MUFFIN      D:\WTRGATE\SQUISH\MUFFIN -$ -$m200 -$d5
  6263. EchoArea POINTS.028  D:\WTRGATE\SQUISH\PNT028 -$ -$m200 -$d5
  6264.  
  6265. WaterGate understands the -$, -0 and -F area types, to indicate a 
  6266. Squish, passthrough and *.MSG area style. In addition, the -J switch 
  6267. is also used to indicate JAM style areas. When using the "Export 
  6268. Squish like Area config", as a non-standard addition, JAM areas are 
  6269. also exported using this '-J' option, but each line is preceded with 
  6270. a ';' to make sure other programs ignore those lines. The 
  6271. "Import/Export" menu has another option, called "Import AREAS.BBS 
  6272. file", which is useful if you want to delete a certain node from a 
  6273. list of areas without using the normal 'tag & delete' options. You 
  6274. can use another program to prepare a file containing a list of areas 
  6275. that have to be added or deleted. When you select a file, you are 
  6276. asked for which user you want to make these modifications. The 
  6277. format of the input file:
  6278.  
  6279. +ARENA        ; Add an area
  6280. +CHESS.INT    ; Add an area
  6281. -POINTS.028   ; Delete an area
  6282. ....          ; etc etc
  6283.  
  6284. Note: No '%' commands for normal AreaFix operation are available.
  6285. WaterGate Manual       Command line parameters              Page 138
  6286. ---------------------------------------------------------------------
  6287. Command line parameters
  6288. -----------------------
  6289.  
  6290. WTRGATE.EXE
  6291. -----------
  6292.  
  6293. This is the main program. It must be correctly configured to run; the
  6294. program will exit if it is unable to initialize. To create new 
  6295. configuration files, or modify an existing configuration, use the 
  6296. WtrConf program.
  6297.  
  6298. You can start WaterGate using a command line option or you can start 
  6299. it without one and select an option from the menu. Only a single 
  6300. command line option is available for each run.
  6301.  
  6302. When scanning for outgoing Fido echomail messages, the program will 
  6303. look for an ECHOTOSS.LOG or ECHOMAIL.JAM file in its system 
  6304. directory, containing a listing of the areas it has to scan.
  6305.  
  6306. ?
  6307.      Display a short help screen.
  6308.  
  6309. SCAN
  6310.      Scans local message bases for outgoing messages.
  6311.  
  6312. TOSS
  6313.      Toss received FidoNet from inbound.
  6314.  
  6315. UUCP
  6316.      Toss received Usenet/Internet from spool directory.
  6317.  
  6318. BAG
  6319.      Toss received BAG files.
  6320.  
  6321. SMTP
  6322.      Toss received SMTP files from Mail Queue.
  6323.  
  6324. -NONETSCAN
  6325.      Skip the scanning of all netmail areas for outgoing messages. 
  6326.      The primary netmail area is stilled scanned for pending file 
  6327.      attaches (FrontDoor mode only). This tells SCAN to check echo 
  6328.      and local areas only.
  6329.  
  6330. -NOECHOSCAN
  6331.      Skip the scanning of all echomail areas. A shorter alias for 
  6332.      this option is -NOES.
  6333.  
  6334. -NONETMAIL
  6335.      Do not route netmail messages; store them in the local netmail 
  6336.      area instead.
  6337.  
  6338. -NOEXPORT
  6339.      Do not export messages to other systems; only import local 
  6340.      messages.
  6341.  
  6342. WaterGate Manual       Command line parameters              Page 139
  6343. ---------------------------------------------------------------------
  6344. -NOLOCAL
  6345.      Don't import local messages; only export them to up and 
  6346.      downlinks.
  6347.  
  6348. -NODUPE
  6349.      Force dupe checking off.
  6350.  
  6351. -NOCHECK
  6352.      Force WaterGate to ignore the directory check at startup.
  6353.  
  6354. -NONEWSTOSS
  6355.      Do not toss Usenet news batches, only e-mail.
  6356.  
  6357. -KEEPFA
  6358.      Keep file attach netmail when the attached file cannot be found.
  6359.      This can used for busy LANs that report a file as "not found" 
  6360.      when actually the LAN is to busy.
  6361.  
  6362. -MEMUSAGE
  6363.      Report in the logfile the amount of memory used for each of the 
  6364.      configuration table that are loaded at start-up. This will help 
  6365.      you understand WaterGate's memory consumption.
  6366.  
  6367. Errorlevel returns 0 on success or >1 on failure.
  6368.  
  6369. WTRCONF.EXE
  6370. -----------
  6371.  
  6372. You will need this program to configure WaterGate; it is capable of 
  6373. creating and modifying configuration files, including the areabase 
  6374. and userbase files. For more information see "Installing WaterGate".
  6375.  
  6376. ?
  6377.      Show help screen.
  6378.  
  6379. EXPORT_SQUISH file
  6380.      Exports a SQUISH.CFG file containing all areas defined in the 
  6381.      configuration. Or use [file] to specify another file name.
  6382.  
  6383. EXPORT_AREAS file
  6384.      Exports an AREAS.BBS file containing all areas defined in the 
  6385.      configuration. Or use [file] to specify another file name.
  6386.  
  6387. IGNORE_SYSTEMDIR
  6388.      WaterGate will ignore the System Directory as configured in 
  6389.      WTRCFG.TDB. This allows you to use a configuration in an other 
  6390.      directory than the original. Useful when checking somebody 
  6391.      else's databases.
  6392.  
  6393. Errorlevel returns 0 on success or >1 on failure.
  6394.  
  6395. WTRUTIL.EXE
  6396. -----------
  6397.  
  6398. WaterGate comes with a messagebase maintenance utility called 
  6399. WtrUtil. It can link messages in all area types; remove messages 
  6400. WaterGate Manual       Command line parameters              Page 140
  6401. ---------------------------------------------------------------------
  6402. that are too old or over the maximum number of messages in an area; 
  6403. create new index files for both Squish and Jam bases; and renumber 
  6404. areas.
  6405.  
  6406. You can start WtrUtil with command line options, or start it without 
  6407. one and simply select from the menu.
  6408.  
  6409. ?
  6410.      Show all command line options.
  6411.  
  6412. DATABASE
  6413.      Removes deleted entries and unused links from all WaterGate's 
  6414.      configuration files, rebuild the databases and sort the 
  6415.      areabase for faster access by WtrConf.
  6416.      Use -NOSORT to prevent the areabase from being sorted.
  6417.  
  6418. INDEX
  6419.      Creates new index files for all Squish and JAM message bases.
  6420.  
  6421. LINK
  6422.      Links messages in all areas.
  6423.  
  6424. RENUM
  6425.      Renumbers all *.MSG areas.
  6426.  
  6427. RENUMJAM
  6428.      Renumbers all JAM areas.
  6429.  
  6430. PURGE
  6431.      Removes messages by number and date from all message bases.
  6432.  
  6433. IMPORT
  6434.      This function imports messages from your *.MSG main netmail 
  6435.      directory into a JAM or Squish netmail area.
  6436.  
  6437.      IMPORT AREANAME [Address] [-NoKill]
  6438.  
  6439.      AREANAME specifies the name of the netmail base to which the 
  6440.      messages are to be imported.
  6441.  
  6442.      Address specifies the AKA to which the messages have to be 
  6443.      addressed to be selected for import. This parameter is 
  6444.      optional; if not specified all your AKA's are used.
  6445.  
  6446.      The -NoKill parameter ensures that the imported messages are not
  6447.      removed from your netmail directory, which is the default.
  6448.  
  6449. SHRINKLOG n
  6450.      This function will clean the logfile and all leaving only 
  6451.      today's plus n days of history, as supplied on the command 
  6452.      line. For example, SHRINKLOG 6 will keep a whole week in the 
  6453.      logfile.
  6454.  
  6455. -NOSLICE
  6456.      Use this option to disable the time slicing support, in case it 
  6457.      causes problems, or when you want to speed up processing without
  6458. WaterGate Manual       Command line parameters              Page 141
  6459. ---------------------------------------------------------------------
  6460.      giving up time slices anymore.
  6461.  
  6462. Errorlevel returns 0 on success or >1 on failure.
  6463.  
  6464. Use the DATABASE option if you have removed large numbers of areas or
  6465. users from your configuration. Letting them stay in the base only 
  6466. wastes memory and disk access time.
  6467.  
  6468. Since WtrConf has to sort the list of area names all the times, you 
  6469. can speed up the editing work in WtrConf greatly by sorting the area 
  6470. base with WtrUtil on a regular basis, for example every night.
  6471.  
  6472. Groups filter option
  6473. --------------------
  6474.  
  6475. To limit the number of areas that WtrUtil processes during the INDEX,
  6476. LINK, PURGE, RENUM and RENUMJAM options, you can add an extra command
  6477. line argument to these options to tell WtrUtil which groups to 
  6478. process only.
  6479.  
  6480. For example:
  6481.  
  6482. WTRUTIL LINK       Links messages in all areas.
  6483. WTRUTIL LINK ABC   Links messages in areas that are in one of the
  6484.                    groups A B and C.
  6485.  
  6486. Notice that the groups filter option only works when using the five 
  6487. functions from the command line.
  6488. WaterGate Manual       Appendixes                           Page 142
  6489. ---------------------------------------------------------------------
  6490. Appendixes
  6491. ----------
  6492.  
  6493. Appendix A: Message Bases
  6494. -------------------------
  6495.  
  6496. If you receive messages, you will need a place to store them. 
  6497. WaterGate has built in support for three different messagebase 
  6498. types, each with its own characteristics. None of the supported 
  6499. bases puts more than one area into the same base, so if one area 
  6500. crashes for some reason, you won't lose more than just that area.
  6501.  
  6502. Both the Squish base and the JAM base can be considered successors 
  6503. to the Hudson Message Base. The HMB was a replacement for the Fido 
  6504. *.MSG base, but its limit of 200 message areas and maximum size of 
  6505. 16Mb makes it somewhat outdated compared to the huge message traffic 
  6506. produced by the various networks today. The Hudson Message Base is 
  6507. not supported by WaterGate.
  6508.  
  6509. Fido *.MSG
  6510. ----------
  6511.  
  6512. This is the oldest format, and is defined by FTS-0001. This format 
  6513. needs a sub-directory for each defined area. Every message is put 
  6514. into a single file, so this format is not recommended for areas that 
  6515. receive lots of messages, especially when using standard DOS FAT 
  6516. formatted hard disks. These become incredibly slow when the number 
  6517. of files in a single directory exceeds 256.
  6518.  
  6519. This type of base is compatible with almost any piece of software 
  6520. written for Fido. So you probably want to use it for your netmail 
  6521. directory, to allow other programs to easily insert messages.
  6522.  
  6523. If you create a Fido *.MSG area, make sure you enter a valid 
  6524. directory name in the "Area path" field, with a terminating 
  6525. backslash. WaterGate Manual       Appendixes                           Page 143
  6526. ---------------------------------------------------------------------
  6527.  
  6528.  
  6529. Examples:
  6530.  
  6531. C:\WSD\NETMAIL\
  6532. C:\WSD\NETMAIL\HISTORY\
  6533.  
  6534. Squish
  6535. ------
  6536.  
  6537. Squish was designed in 1990 by Scott Dudley, and it is used in his 
  6538. Maximus BBS package and Squish mail processor. It uses 4 different 
  6539. files for each area: <name>.SQD contains the messages and header 
  6540. information; <name>.SQI contains an index to the messages in the SQD 
  6541. file; <name>.SQL contains lastread pointers for BBS users; and 
  6542. <name>.SQB contains dupecheck information. The SQB file is not used 
  6543. by WaterGate.
  6544.  
  6545. A Squish base can contain up to 2^32 (2 to the 32nd power) messages, 
  6546. which should be enough for anybody. (Don't quote me on this one, 
  6547. please.) If it isn't, you probably have more serious problems.
  6548.  
  6549. A Squish base can re-use space occupied by deleted messages without 
  6550. needing repacking, so you don't need to pack a Squish base as often 
  6551. as other types.
  6552.  
  6553. If you set a maximum number of messages for a Squish area, WaterGate 
  6554. will automatically delete the oldest message. So, the area never 
  6555. contains more than the set number of messages. Don't set this number 
  6556. too low, because if WaterGate has to delete large numbers of messages
  6557. in each run, performance will suffer. If you want maximum performance
  6558. and don't care about disk space, just set the limit to 0 messages.
  6559.  
  6560. If you use the Squish base for an area, the "Area Path" should 
  6561. contain a valid directory plus an 8 character area name. Don't use 
  6562. any extensions (.???) in the path and don't put a backslash at the 
  6563. end! WaterGate Manual       Appendixes                           Page 144
  6564. ---------------------------------------------------------------------
  6565.  
  6566.  
  6567. Examples:
  6568.  
  6569. C:\BBS\SQUISH\ALTBBS    for the area ALT.BBS
  6570. C:\BBS\SQUISH\ALTBMISC    for the area ALT.BBS.MISC
  6571. etc.
  6572.  
  6573. JAM
  6574. ---
  6575.  
  6576. JAM was designed in 1993 by Joaquim Homrighausen, Andrew Milner, 
  6577. Mats Birch, and Mats Wallin. Like Squish, it is designed to support 
  6578. up to 2^32 messages in a single message area and uses 4 different 
  6579. files.
  6580.  
  6581. It uses a <name>.JHR file to store header information; each header 
  6582. consists of a fixed part and a flexible part, depending on the 
  6583. message. Storing only a small part in the fixed header makes it 
  6584. relatively easy to add future enhancements to the message base. Each 
  6585. header contains a pointer into the <name>.JDT file, which contains 
  6586. the actual message. The areabase is indexed in the <name>.JDX file 
  6587. and lastread information is stored into the <name>.JLR file.
  6588.  
  6589. JAM has a (for Fido systems) new way of linking messages: instead of 
  6590. simply linking messages with the same subject, each message can have 
  6591. an unlimited number of replies to it, so that each reply is a reply 
  6592. to the original message. This way you can always see to which message
  6593. a new message is a reply. WaterGate Manual       Appendixes                           Page 145
  6594. ---------------------------------------------------------------------
  6595.  
  6596.  
  6597. Example:
  6598.  
  6599. 1 --- 2 --- 4 --- 5
  6600. |     |
  6601. |     +---- 8
  6602. |
  6603. +---- 3 --- 7
  6604. |
  6605. +---- 6
  6606.  
  6607. Messages 2, 3, and 6 are a reply to message 1. Message 4 and 8 are a 
  6608. reply to message 2. Message 5 is a reply to message 4. Message 7 is a
  6609. reply to message 3.
  6610.  
  6611. If you use the JAM base for an area, the "Area Path" should contain a
  6612. valid directory plus an 8 character area name. Don't use any 
  6613. extensions (.xxx) in the path and don't use a terminating backslash! WaterGate Manual       Appendixes                           Page 146
  6614. ---------------------------------------------------------------------
  6615.  
  6616.  
  6617. Examples:
  6618.  
  6619. C:\BBS\JAM\ALTBBS        for the area ALT.BBS
  6620. C:\BBS\JAM\ALTBMISC        for the area ALT.BBS.MISC
  6621. etc.
  6622.  
  6623. WaterGate Manual       Appendixes                           Page 147
  6624. ---------------------------------------------------------------------
  6625. Appendix B: Error codes
  6626. -----------------------
  6627.  
  6628. Below is a description for most of the error numbers that WaterGate 
  6629. writes in the logfile.
  6630.  
  6631. This should help you understand the error message better.
  6632.  
  6633. Code    Description
  6634.  
  6635. 2    File not found
  6636. 3    Path not found
  6637. 4    Too many open files
  6638. 5    File access denied
  6639. 100    Disk read error
  6640. 101    Disk write error
  6641. 150    Disk is write-protected
  6642. 158    Sector not found
  6643. 200    Division by zero
  6644. 202    Stack overflow error
  6645. 216    General Protection fault
  6646.  
  6647. WaterGate Manual       Appendixes                           Page 148
  6648. ---------------------------------------------------------------------
  6649. Appendix C: Trademarks
  6650. ----------------------
  6651.  
  6652. All trademarks are owned by their respective owners,
  6653.  
  6654. ARC,ZIP          PkWare, Inc
  6655. ARJ              Robert K. Jung
  6656. Binkley          Bit Bucket Software Co.
  6657. Fido             Tom Jennings
  6658. FrontDoor        Joaquim Homrighausen, Absolute Solutions
  6659. GEcho            Gerard J. van der Land
  6660. JAM (mbp)        Joaquim Homrighausen, Andrew Milner,
  6661.                  Mats Birch, Mats Wallin
  6662. LHA              Haruyasu Yoshizaka
  6663. MS-DOS           Microsoft Corporation
  6664. PAK              NoGate Consulting
  6665. PC-DOS,OS/2      IBM
  6666. Pentium          Intel
  6667. Squish,Maximus   Scott J. Dudley
  6668. TimEd            Gerard van Essen
  6669. Waffle           DarkSide International
  6670. MailTunnel       Waterline Software Development
  6671.  
  6672. WaterGate Manual       Appendixes                           Page 149
  6673. ---------------------------------------------------------------------
  6674. Appendix D: WaterGate Development
  6675. ---------------------------------
  6676.  
  6677. People sometimes ask me about the environment I use to develop 
  6678. WaterGate, so below follows a little explanation.
  6679.  
  6680.    - All code is written in Borland Pascal 7.0 on a Pentium 
  6681.      150Mhz/32MB/2G running Microsoft Windows '95.
  6682.    - The user interface is the so called "Ramon Unit" which I 
  6683.      started about ten years ago. It is optimized for speed and 
  6684.      handles all the menus, lists, field editing, help file, etc.
  6685.    - WaterGate is about 100 source files containing 70000 lines of 
  6686.      code.
  6687.    - The manual is written in a HTML-like source format and compiled 
  6688.      by two different programs into the final HTML version and the 
  6689.      ASCII version. This allows me to maintain one set of documents 
  6690.      and produce both manuals in a few seconds.
  6691.  
  6692.